gphys 1.1.1 → 1.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/.gitignore +17 -0
- data/ChangeLog +221 -0
- data/Gemfile +4 -0
- data/LICENSE.txt +18 -30
- data/README +23 -26
- data/README.md +29 -0
- data/Rakefile +1 -56
- data/bin/gpaop +2 -1
- data/bin/gpcut +3 -2
- data/bin/gpedit +6 -2
- data/bin/gpmath +3 -2
- data/bin/gpmaxmin +3 -2
- data/bin/gpprint +2 -1
- data/bin/gpvect +28 -5
- data/bin/gpview +43 -5
- data/extconf.rb +5 -6
- data/gphys.gemspec +34 -0
- data/interpo.c +63 -24
- data/lib/gphys.rb +2 -0
- data/lib/numru/dclext.rb +2636 -0
- data/lib/numru/derivative.rb +53 -12
- data/lib/numru/ganalysis/eof.rb +4 -0
- data/lib/numru/ganalysis/histogram.rb +73 -5
- data/lib/numru/ganalysis/met.rb +163 -2
- data/lib/numru/ganalysis/planet.rb +230 -20
- data/lib/numru/ggraph.rb +147 -2247
- data/lib/numru/gphys/assoccoords.rb +19 -3
- data/lib/numru/gphys/axis.rb +1 -1
- data/lib/numru/gphys/coordmapping.rb +2 -2
- data/lib/numru/gphys/derivative.rb +56 -13
- data/lib/numru/gphys/gphys.rb +17 -1
- data/lib/numru/gphys/gphys_grads_io.rb +6 -5
- data/lib/numru/gphys/gphys_grib_io.rb +6 -6
- data/lib/numru/gphys/gphys_io.rb +25 -6
- data/lib/numru/gphys/grads_gridded.rb +31 -29
- data/lib/numru/gphys/grib.rb +13 -9
- data/lib/numru/gphys/interpolate.rb +153 -29
- data/lib/numru/gphys/unumeric.rb +29 -6
- data/lib/numru/gphys/varray.rb +9 -0
- data/lib/numru/gphys/varraygrib.rb +70 -8
- data/lib/version.rb +3 -0
- metadata +247 -531
- data/doc/attribute.html +0 -19
- data/doc/attributenetcdf.html +0 -15
- data/doc/axis.html +0 -376
- data/doc/coordmapping.html +0 -111
- data/doc/coordtransform.html +0 -36
- data/doc/derivative/gphys-derivative.html +0 -80
- data/doc/derivative/index.html +0 -21
- data/doc/derivative/index.rd +0 -14
- data/doc/derivative/math-doc/document/document.css +0 -30
- data/doc/derivative/math-doc/document/document.html +0 -57
- data/doc/derivative/math-doc/document/images.aux +0 -1
- data/doc/derivative/math-doc/document/images.log +0 -385
- data/doc/derivative/math-doc/document/images.pl +0 -186
- data/doc/derivative/math-doc/document/images.tex +0 -364
- data/doc/derivative/math-doc/document/img1.png +0 -0
- data/doc/derivative/math-doc/document/img10.png +0 -0
- data/doc/derivative/math-doc/document/img11.png +0 -0
- data/doc/derivative/math-doc/document/img12.png +0 -0
- data/doc/derivative/math-doc/document/img13.png +0 -0
- data/doc/derivative/math-doc/document/img14.png +0 -0
- data/doc/derivative/math-doc/document/img15.png +0 -0
- data/doc/derivative/math-doc/document/img16.png +0 -0
- data/doc/derivative/math-doc/document/img17.png +0 -0
- data/doc/derivative/math-doc/document/img18.png +0 -0
- data/doc/derivative/math-doc/document/img19.png +0 -0
- data/doc/derivative/math-doc/document/img2.png +0 -0
- data/doc/derivative/math-doc/document/img20.png +0 -0
- data/doc/derivative/math-doc/document/img21.png +0 -0
- data/doc/derivative/math-doc/document/img22.png +0 -0
- data/doc/derivative/math-doc/document/img23.png +0 -0
- data/doc/derivative/math-doc/document/img24.png +0 -0
- data/doc/derivative/math-doc/document/img25.png +0 -0
- data/doc/derivative/math-doc/document/img26.png +0 -0
- data/doc/derivative/math-doc/document/img27.png +0 -0
- data/doc/derivative/math-doc/document/img28.png +0 -0
- data/doc/derivative/math-doc/document/img29.png +0 -0
- data/doc/derivative/math-doc/document/img3.png +0 -0
- data/doc/derivative/math-doc/document/img30.png +0 -0
- data/doc/derivative/math-doc/document/img4.png +0 -0
- data/doc/derivative/math-doc/document/img5.png +0 -0
- data/doc/derivative/math-doc/document/img6.png +0 -0
- data/doc/derivative/math-doc/document/img7.png +0 -0
- data/doc/derivative/math-doc/document/img8.png +0 -0
- data/doc/derivative/math-doc/document/img9.png +0 -0
- data/doc/derivative/math-doc/document/index.html +0 -57
- data/doc/derivative/math-doc/document/labels.pl +0 -13
- data/doc/derivative/math-doc/document/next.png +0 -0
- data/doc/derivative/math-doc/document/next_g.png +0 -0
- data/doc/derivative/math-doc/document/node1.html +0 -238
- data/doc/derivative/math-doc/document/node2.html +0 -75
- data/doc/derivative/math-doc/document/prev.png +0 -0
- data/doc/derivative/math-doc/document/prev_g.png +0 -0
- data/doc/derivative/math-doc/document/up.png +0 -0
- data/doc/derivative/math-doc/document/up_g.png +0 -0
- data/doc/derivative/math-doc/document.pdf +0 -0
- data/doc/derivative/math-doc/document.tex +0 -158
- data/doc/derivative/numru-derivative.html +0 -129
- data/doc/ep_flux/ep_flux.html +0 -469
- data/doc/ep_flux/ggraph_on_merdional_section.html +0 -71
- data/doc/ep_flux/index.html +0 -31
- data/doc/ep_flux/index.rd +0 -24
- data/doc/ep_flux/math-doc/document/WARNINGS +0 -1
- data/doc/ep_flux/math-doc/document/contents.png +0 -0
- data/doc/ep_flux/math-doc/document/crossref.png +0 -0
- data/doc/ep_flux/math-doc/document/document.css +0 -30
- data/doc/ep_flux/math-doc/document/document.html +0 -101
- data/doc/ep_flux/math-doc/document/images.aux +0 -1
- data/doc/ep_flux/math-doc/document/images.log +0 -1375
- data/doc/ep_flux/math-doc/document/images.pl +0 -1328
- data/doc/ep_flux/math-doc/document/images.tex +0 -1471
- data/doc/ep_flux/math-doc/document/img1.png +0 -0
- data/doc/ep_flux/math-doc/document/img10.png +0 -0
- data/doc/ep_flux/math-doc/document/img100.png +0 -0
- data/doc/ep_flux/math-doc/document/img101.png +0 -0
- data/doc/ep_flux/math-doc/document/img102.png +0 -0
- data/doc/ep_flux/math-doc/document/img103.png +0 -0
- data/doc/ep_flux/math-doc/document/img104.png +0 -0
- data/doc/ep_flux/math-doc/document/img105.png +0 -0
- data/doc/ep_flux/math-doc/document/img106.png +0 -0
- data/doc/ep_flux/math-doc/document/img107.png +0 -0
- data/doc/ep_flux/math-doc/document/img108.png +0 -0
- data/doc/ep_flux/math-doc/document/img109.png +0 -0
- data/doc/ep_flux/math-doc/document/img11.png +0 -0
- data/doc/ep_flux/math-doc/document/img110.png +0 -0
- data/doc/ep_flux/math-doc/document/img111.png +0 -0
- data/doc/ep_flux/math-doc/document/img112.png +0 -0
- data/doc/ep_flux/math-doc/document/img113.png +0 -0
- data/doc/ep_flux/math-doc/document/img114.png +0 -0
- data/doc/ep_flux/math-doc/document/img115.png +0 -0
- data/doc/ep_flux/math-doc/document/img116.png +0 -0
- data/doc/ep_flux/math-doc/document/img117.png +0 -0
- data/doc/ep_flux/math-doc/document/img118.png +0 -0
- data/doc/ep_flux/math-doc/document/img119.png +0 -0
- data/doc/ep_flux/math-doc/document/img12.png +0 -0
- data/doc/ep_flux/math-doc/document/img120.png +0 -0
- data/doc/ep_flux/math-doc/document/img121.png +0 -0
- data/doc/ep_flux/math-doc/document/img122.png +0 -0
- data/doc/ep_flux/math-doc/document/img123.png +0 -0
- data/doc/ep_flux/math-doc/document/img124.png +0 -0
- data/doc/ep_flux/math-doc/document/img125.png +0 -0
- data/doc/ep_flux/math-doc/document/img126.png +0 -0
- data/doc/ep_flux/math-doc/document/img127.png +0 -0
- data/doc/ep_flux/math-doc/document/img128.png +0 -0
- data/doc/ep_flux/math-doc/document/img129.png +0 -0
- data/doc/ep_flux/math-doc/document/img13.png +0 -0
- data/doc/ep_flux/math-doc/document/img130.png +0 -0
- data/doc/ep_flux/math-doc/document/img131.png +0 -0
- data/doc/ep_flux/math-doc/document/img132.png +0 -0
- data/doc/ep_flux/math-doc/document/img133.png +0 -0
- data/doc/ep_flux/math-doc/document/img134.png +0 -0
- data/doc/ep_flux/math-doc/document/img135.png +0 -0
- data/doc/ep_flux/math-doc/document/img136.png +0 -0
- data/doc/ep_flux/math-doc/document/img137.png +0 -0
- data/doc/ep_flux/math-doc/document/img138.png +0 -0
- data/doc/ep_flux/math-doc/document/img139.png +0 -0
- data/doc/ep_flux/math-doc/document/img14.png +0 -0
- data/doc/ep_flux/math-doc/document/img140.png +0 -0
- data/doc/ep_flux/math-doc/document/img141.png +0 -0
- data/doc/ep_flux/math-doc/document/img142.png +0 -0
- data/doc/ep_flux/math-doc/document/img143.png +0 -0
- data/doc/ep_flux/math-doc/document/img144.png +0 -0
- data/doc/ep_flux/math-doc/document/img145.png +0 -0
- data/doc/ep_flux/math-doc/document/img146.png +0 -0
- data/doc/ep_flux/math-doc/document/img147.png +0 -0
- data/doc/ep_flux/math-doc/document/img148.png +0 -0
- data/doc/ep_flux/math-doc/document/img149.png +0 -0
- data/doc/ep_flux/math-doc/document/img15.png +0 -0
- data/doc/ep_flux/math-doc/document/img150.png +0 -0
- data/doc/ep_flux/math-doc/document/img151.png +0 -0
- data/doc/ep_flux/math-doc/document/img152.png +0 -0
- data/doc/ep_flux/math-doc/document/img153.png +0 -0
- data/doc/ep_flux/math-doc/document/img154.png +0 -0
- data/doc/ep_flux/math-doc/document/img155.png +0 -0
- data/doc/ep_flux/math-doc/document/img156.png +0 -0
- data/doc/ep_flux/math-doc/document/img157.png +0 -0
- data/doc/ep_flux/math-doc/document/img158.png +0 -0
- data/doc/ep_flux/math-doc/document/img159.png +0 -0
- data/doc/ep_flux/math-doc/document/img16.png +0 -0
- data/doc/ep_flux/math-doc/document/img160.png +0 -0
- data/doc/ep_flux/math-doc/document/img161.png +0 -0
- data/doc/ep_flux/math-doc/document/img162.png +0 -0
- data/doc/ep_flux/math-doc/document/img163.png +0 -0
- data/doc/ep_flux/math-doc/document/img164.png +0 -0
- data/doc/ep_flux/math-doc/document/img165.png +0 -0
- data/doc/ep_flux/math-doc/document/img166.png +0 -0
- data/doc/ep_flux/math-doc/document/img167.png +0 -0
- data/doc/ep_flux/math-doc/document/img168.png +0 -0
- data/doc/ep_flux/math-doc/document/img169.png +0 -0
- data/doc/ep_flux/math-doc/document/img17.png +0 -0
- data/doc/ep_flux/math-doc/document/img170.png +0 -0
- data/doc/ep_flux/math-doc/document/img171.png +0 -0
- data/doc/ep_flux/math-doc/document/img172.png +0 -0
- data/doc/ep_flux/math-doc/document/img173.png +0 -0
- data/doc/ep_flux/math-doc/document/img174.png +0 -0
- data/doc/ep_flux/math-doc/document/img175.png +0 -0
- data/doc/ep_flux/math-doc/document/img176.png +0 -0
- data/doc/ep_flux/math-doc/document/img177.png +0 -0
- data/doc/ep_flux/math-doc/document/img178.png +0 -0
- data/doc/ep_flux/math-doc/document/img179.png +0 -0
- data/doc/ep_flux/math-doc/document/img18.png +0 -0
- data/doc/ep_flux/math-doc/document/img180.png +0 -0
- data/doc/ep_flux/math-doc/document/img181.png +0 -0
- data/doc/ep_flux/math-doc/document/img182.png +0 -0
- data/doc/ep_flux/math-doc/document/img183.png +0 -0
- data/doc/ep_flux/math-doc/document/img184.png +0 -0
- data/doc/ep_flux/math-doc/document/img185.png +0 -0
- data/doc/ep_flux/math-doc/document/img186.png +0 -0
- data/doc/ep_flux/math-doc/document/img187.png +0 -0
- data/doc/ep_flux/math-doc/document/img188.png +0 -0
- data/doc/ep_flux/math-doc/document/img189.png +0 -0
- data/doc/ep_flux/math-doc/document/img19.png +0 -0
- data/doc/ep_flux/math-doc/document/img190.png +0 -0
- data/doc/ep_flux/math-doc/document/img191.png +0 -0
- data/doc/ep_flux/math-doc/document/img192.png +0 -0
- data/doc/ep_flux/math-doc/document/img193.png +0 -0
- data/doc/ep_flux/math-doc/document/img194.png +0 -0
- data/doc/ep_flux/math-doc/document/img195.png +0 -0
- data/doc/ep_flux/math-doc/document/img196.png +0 -0
- data/doc/ep_flux/math-doc/document/img197.png +0 -0
- data/doc/ep_flux/math-doc/document/img198.png +0 -0
- data/doc/ep_flux/math-doc/document/img199.png +0 -0
- data/doc/ep_flux/math-doc/document/img2.png +0 -0
- data/doc/ep_flux/math-doc/document/img20.png +0 -0
- data/doc/ep_flux/math-doc/document/img200.png +0 -0
- data/doc/ep_flux/math-doc/document/img21.png +0 -0
- data/doc/ep_flux/math-doc/document/img22.png +0 -0
- data/doc/ep_flux/math-doc/document/img23.png +0 -0
- data/doc/ep_flux/math-doc/document/img24.png +0 -0
- data/doc/ep_flux/math-doc/document/img25.png +0 -0
- data/doc/ep_flux/math-doc/document/img26.png +0 -0
- data/doc/ep_flux/math-doc/document/img27.png +0 -0
- data/doc/ep_flux/math-doc/document/img28.png +0 -0
- data/doc/ep_flux/math-doc/document/img29.png +0 -0
- data/doc/ep_flux/math-doc/document/img3.png +0 -0
- data/doc/ep_flux/math-doc/document/img30.png +0 -0
- data/doc/ep_flux/math-doc/document/img31.png +0 -0
- data/doc/ep_flux/math-doc/document/img32.png +0 -0
- data/doc/ep_flux/math-doc/document/img33.png +0 -0
- data/doc/ep_flux/math-doc/document/img34.png +0 -0
- data/doc/ep_flux/math-doc/document/img35.png +0 -0
- data/doc/ep_flux/math-doc/document/img36.png +0 -0
- data/doc/ep_flux/math-doc/document/img37.png +0 -0
- data/doc/ep_flux/math-doc/document/img38.png +0 -0
- data/doc/ep_flux/math-doc/document/img39.png +0 -0
- data/doc/ep_flux/math-doc/document/img4.png +0 -0
- data/doc/ep_flux/math-doc/document/img40.png +0 -0
- data/doc/ep_flux/math-doc/document/img41.png +0 -0
- data/doc/ep_flux/math-doc/document/img42.png +0 -0
- data/doc/ep_flux/math-doc/document/img43.png +0 -0
- data/doc/ep_flux/math-doc/document/img44.png +0 -0
- data/doc/ep_flux/math-doc/document/img45.png +0 -0
- data/doc/ep_flux/math-doc/document/img46.png +0 -0
- data/doc/ep_flux/math-doc/document/img47.png +0 -0
- data/doc/ep_flux/math-doc/document/img48.png +0 -0
- data/doc/ep_flux/math-doc/document/img49.png +0 -0
- data/doc/ep_flux/math-doc/document/img5.png +0 -0
- data/doc/ep_flux/math-doc/document/img50.png +0 -0
- data/doc/ep_flux/math-doc/document/img51.png +0 -0
- data/doc/ep_flux/math-doc/document/img52.png +0 -0
- data/doc/ep_flux/math-doc/document/img53.png +0 -0
- data/doc/ep_flux/math-doc/document/img54.png +0 -0
- data/doc/ep_flux/math-doc/document/img55.png +0 -0
- data/doc/ep_flux/math-doc/document/img56.png +0 -0
- data/doc/ep_flux/math-doc/document/img57.png +0 -0
- data/doc/ep_flux/math-doc/document/img58.png +0 -0
- data/doc/ep_flux/math-doc/document/img59.png +0 -0
- data/doc/ep_flux/math-doc/document/img6.png +0 -0
- data/doc/ep_flux/math-doc/document/img60.png +0 -0
- data/doc/ep_flux/math-doc/document/img61.png +0 -0
- data/doc/ep_flux/math-doc/document/img62.png +0 -0
- data/doc/ep_flux/math-doc/document/img63.png +0 -0
- data/doc/ep_flux/math-doc/document/img64.png +0 -0
- data/doc/ep_flux/math-doc/document/img65.png +0 -0
- data/doc/ep_flux/math-doc/document/img66.png +0 -0
- data/doc/ep_flux/math-doc/document/img67.png +0 -0
- data/doc/ep_flux/math-doc/document/img68.png +0 -0
- data/doc/ep_flux/math-doc/document/img69.png +0 -0
- data/doc/ep_flux/math-doc/document/img7.png +0 -0
- data/doc/ep_flux/math-doc/document/img70.png +0 -0
- data/doc/ep_flux/math-doc/document/img71.png +0 -0
- data/doc/ep_flux/math-doc/document/img72.png +0 -0
- data/doc/ep_flux/math-doc/document/img73.png +0 -0
- data/doc/ep_flux/math-doc/document/img74.png +0 -0
- data/doc/ep_flux/math-doc/document/img75.png +0 -0
- data/doc/ep_flux/math-doc/document/img76.png +0 -0
- data/doc/ep_flux/math-doc/document/img77.png +0 -0
- data/doc/ep_flux/math-doc/document/img78.png +0 -0
- data/doc/ep_flux/math-doc/document/img79.png +0 -0
- data/doc/ep_flux/math-doc/document/img8.png +0 -0
- data/doc/ep_flux/math-doc/document/img80.png +0 -0
- data/doc/ep_flux/math-doc/document/img81.png +0 -0
- data/doc/ep_flux/math-doc/document/img82.png +0 -0
- data/doc/ep_flux/math-doc/document/img83.png +0 -0
- data/doc/ep_flux/math-doc/document/img84.png +0 -0
- data/doc/ep_flux/math-doc/document/img85.png +0 -0
- data/doc/ep_flux/math-doc/document/img86.png +0 -0
- data/doc/ep_flux/math-doc/document/img87.png +0 -0
- data/doc/ep_flux/math-doc/document/img88.png +0 -0
- data/doc/ep_flux/math-doc/document/img89.png +0 -0
- data/doc/ep_flux/math-doc/document/img9.png +0 -0
- data/doc/ep_flux/math-doc/document/img90.png +0 -0
- data/doc/ep_flux/math-doc/document/img91.png +0 -0
- data/doc/ep_flux/math-doc/document/img92.png +0 -0
- data/doc/ep_flux/math-doc/document/img93.png +0 -0
- data/doc/ep_flux/math-doc/document/img94.png +0 -0
- data/doc/ep_flux/math-doc/document/img95.png +0 -0
- data/doc/ep_flux/math-doc/document/img96.png +0 -0
- data/doc/ep_flux/math-doc/document/img97.png +0 -0
- data/doc/ep_flux/math-doc/document/img98.png +0 -0
- data/doc/ep_flux/math-doc/document/img99.png +0 -0
- data/doc/ep_flux/math-doc/document/index.html +0 -101
- data/doc/ep_flux/math-doc/document/internals.pl +0 -258
- data/doc/ep_flux/math-doc/document/labels.pl +0 -265
- data/doc/ep_flux/math-doc/document/next.png +0 -0
- data/doc/ep_flux/math-doc/document/next_g.png +0 -0
- data/doc/ep_flux/math-doc/document/node1.html +0 -104
- data/doc/ep_flux/math-doc/document/node10.html +0 -164
- data/doc/ep_flux/math-doc/document/node11.html +0 -86
- data/doc/ep_flux/math-doc/document/node12.html +0 -166
- data/doc/ep_flux/math-doc/document/node13.html +0 -897
- data/doc/ep_flux/math-doc/document/node14.html +0 -1065
- data/doc/ep_flux/math-doc/document/node15.html +0 -72
- data/doc/ep_flux/math-doc/document/node16.html +0 -81
- data/doc/ep_flux/math-doc/document/node2.html +0 -82
- data/doc/ep_flux/math-doc/document/node3.html +0 -91
- data/doc/ep_flux/math-doc/document/node4.html +0 -149
- data/doc/ep_flux/math-doc/document/node5.html +0 -330
- data/doc/ep_flux/math-doc/document/node6.html +0 -99
- data/doc/ep_flux/math-doc/document/node7.html +0 -98
- data/doc/ep_flux/math-doc/document/node8.html +0 -83
- data/doc/ep_flux/math-doc/document/node9.html +0 -140
- data/doc/ep_flux/math-doc/document/prev.png +0 -0
- data/doc/ep_flux/math-doc/document/prev_g.png +0 -0
- data/doc/ep_flux/math-doc/document/up.png +0 -0
- data/doc/ep_flux/math-doc/document/up_g.png +0 -0
- data/doc/ep_flux/math-doc/document.pdf +0 -0
- data/doc/ep_flux/math-doc/document.tex +0 -2018
- data/doc/gdir.html +0 -412
- data/doc/gdir_client.html +0 -16
- data/doc/gdir_connect_ftp-like.html +0 -61
- data/doc/gdir_server.html +0 -45
- data/doc/ggraph.html +0 -1615
- data/doc/gpcat.html +0 -44
- data/doc/gpcut.html +0 -41
- data/doc/gphys.html +0 -532
- data/doc/gphys_fft.html +0 -324
- data/doc/gphys_grads_io.html +0 -69
- data/doc/gphys_grib_io.html +0 -82
- data/doc/gphys_io.html +0 -120
- data/doc/gphys_io_common.html +0 -18
- data/doc/gphys_netcdf_io.html +0 -283
- data/doc/gplist.html +0 -24
- data/doc/gpmath.html +0 -51
- data/doc/gpmaxmin.html +0 -31
- data/doc/gpprint.html +0 -34
- data/doc/gpview.html +0 -270
- data/doc/grads2nc_with_gphys.html +0 -21
- data/doc/grads_gridded.html +0 -307
- data/doc/grib.html +0 -144
- data/doc/grid.html +0 -212
- data/doc/index.html +0 -133
- data/doc/index.rd +0 -127
- data/doc/netcdf_convention.html +0 -136
- data/doc/unumeric.html +0 -176
- data/doc/update +0 -64
- data/doc/varray.html +0 -299
- data/doc/varraycomposite.html +0 -67
data/doc/ggraph.html
DELETED
|
@@ -1,1615 +0,0 @@
|
|
|
1
|
-
<?xml version="1.0" ?>
|
|
2
|
-
<!DOCTYPE html
|
|
3
|
-
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
4
|
-
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
5
|
-
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
6
|
-
<head>
|
|
7
|
-
<title>../lib/numru/ggraph.rb</title>
|
|
8
|
-
</head>
|
|
9
|
-
<body>
|
|
10
|
-
<h1><a name="label-0" id="label-0">module NumRu::GGraph and others in ggraph.rb</a></h1><!-- RDLabel: "module NumRu::GGraph and others in ggraph.rb" -->
|
|
11
|
-
<h2><a name="label-1" id="label-1">Index</a></h2><!-- RDLabel: "Index" -->
|
|
12
|
-
<ul>
|
|
13
|
-
<li><a href="#label-2">module NumRu::GGraph</a>
|
|
14
|
-
<ul>
|
|
15
|
-
<li><a href="#label-4">margin_info</a>
|
|
16
|
-
Sets the strings to appear in the bottom margin.</li>
|
|
17
|
-
<li><a href="#label-5">title</a>
|
|
18
|
-
Shows title by <code>DCL.uxmttl('t',string,0.0)</code>.
|
|
19
|
-
Graphic methods such as <a href="#label-25">contour</a> calls this by default.</li>
|
|
20
|
-
<li><a href="#label-6">annotate</a>
|
|
21
|
-
Show texts on the right margin of the viewport.
|
|
22
|
-
Graphic methods such as <a href="#label-25">contour</a> calls this by default.</li>
|
|
23
|
-
<li><a href="#label-7">fig</a>
|
|
24
|
-
Define a figure by setting viewport, window, and coordinate transform
|
|
25
|
-
id (itr) from two 1D VArrays <code>xax</code> and <code>yax</code>.</li>
|
|
26
|
-
<li><a href="#label-8">set_fig</a>
|
|
27
|
-
Change the default option values for <a href="#label-7">fig</a>.</li>
|
|
28
|
-
<li><a href="#label-9">next_fig</a>
|
|
29
|
-
Set the option values effective only in the next call of <a href="#label-7">fig</a>
|
|
30
|
-
(cleared then).</li>
|
|
31
|
-
<li><a href="#label-10">axes</a>
|
|
32
|
-
Draw axes using (by default) info in <code>xax</code> and <code>yax</code> if non-nil.</li>
|
|
33
|
-
<li><a href="#label-11">set_axes</a>
|
|
34
|
-
Change the default option values for <a href="#label-10">axes</a>.</li>
|
|
35
|
-
<li><a href="#label-12">next_axes</a>
|
|
36
|
-
Set the option values effective only in the next call of <a href="#label-10">axes</a>
|
|
37
|
-
(cleared then).</li>
|
|
38
|
-
<li><a href="#label-13">sim_trn?</a>
|
|
39
|
-
Returns whether the current coordinate transformation is a rectangular curvelinear coordinate.</li>
|
|
40
|
-
<li><a href="#label-14">polar_coordinate_boundaries</a>
|
|
41
|
-
Draw boundaries in a polar coordinate.</li>
|
|
42
|
-
<li><a href="#label-15">map_trn?</a>
|
|
43
|
-
Returns whether the current coordinate transformation is a map projection.</li>
|
|
44
|
-
<li><a href="#label-16">map</a>
|
|
45
|
-
(For map projection) Draws map grid and/or lim and/or coast lines etc.</li>
|
|
46
|
-
<li><a href="#label-17">set_map</a>
|
|
47
|
-
Change the default option values for <a href="#label-16">map</a>.</li>
|
|
48
|
-
<li><a href="#label-18">next_map</a>
|
|
49
|
-
Set the option values effective only in the next call of <a href="#label-16">map</a></li>
|
|
50
|
-
<li><a href="#label-19">line</a>
|
|
51
|
-
Plot a poly-line by selecting the first dimension (with GPhys#first1D)
|
|
52
|
-
if <code>gphys</code> is more than 2D.</li>
|
|
53
|
-
<li><a href="#label-20">mark</a>
|
|
54
|
-
Similar to <a href="#label-19">line</a> but plots marks instead of drawing a poly-line.</li>
|
|
55
|
-
<li><a href="#label-21">scatter</a>
|
|
56
|
-
Scatter diagram (using uumrkz, as in <a href="#label-20">mark</a>).</li>
|
|
57
|
-
<li><a href="#label-22">color_scatter</a>
|
|
58
|
-
Scatter diagram colored by values.</li>
|
|
59
|
-
<li><a href="#label-24">tone_and_contour</a>
|
|
60
|
-
Calls <a href="#label-30">tone</a> and <a href="#label-25">contour</a> successively. </li>
|
|
61
|
-
<li><a href="#label-25">contour</a>
|
|
62
|
-
Contour plot by selecting the first 2 dimensions (with GPhys#first2D)
|
|
63
|
-
if <code>gphys</code> is more than 3D.</li>
|
|
64
|
-
<li><!-- Reference, RDLabel "set_contour" doesn't exist --><em class="label-not-found">set_contour</em><!-- Reference end -->
|
|
65
|
-
Set options for contour in general.</li>
|
|
66
|
-
<li><!-- Reference, RDLabel "next_contour" doesn't exist --><em class="label-not-found">next_contour</em><!-- Reference end -->
|
|
67
|
-
Set options for contour in general, which is applied only to the next call.</li>
|
|
68
|
-
<li><a href="#label-26">set_contour_levels</a>
|
|
69
|
-
Set contour levels for <a href="#label-25">contour</a> explicitly by values with the option <code>levels</code>.</li>
|
|
70
|
-
<li><a href="#label-27">clear_contour_levels</a>
|
|
71
|
-
Clear contour levels set by <a href="#label-26">set_contour_levels</a>.</li>
|
|
72
|
-
<li><a href="#label-28">set_linear_contour_options</a>
|
|
73
|
-
Change the default option values regarding linear contour level
|
|
74
|
-
setting in <a href="#label-25">contour</a>.</li>
|
|
75
|
-
<li><a href="#label-29">next_linear_contour_options</a>
|
|
76
|
-
Similar to <a href="#label-28">set_linear_contour_options</a> but the setting
|
|
77
|
-
is effective only for the next call of <a href="#label-25">contour</a>.</li>
|
|
78
|
-
<li><a href="#label-30">tone</a>
|
|
79
|
-
Color tone or shading by selecting the first 2 dimensions
|
|
80
|
-
(with GPhys#first2D) if <code>gphys</code> is more than 3D.</li>
|
|
81
|
-
<li><a href="#label-31">color_bar </a> Color bar</li>
|
|
82
|
-
<li><a href="#label-32">set_tone_levels</a>
|
|
83
|
-
Set tone levels for <a href="#label-30">tone</a> explicitly by values.</li>
|
|
84
|
-
<li><!-- Reference, RDLabel "set_tone" doesn't exist --><em class="label-not-found">set_tone</em><!-- Reference end -->
|
|
85
|
-
Set options for tone in general.</li>
|
|
86
|
-
<li><!-- Reference, RDLabel "next_tone" doesn't exist --><em class="label-not-found">next_tone</em><!-- Reference end -->
|
|
87
|
-
Set options for tone in general, which is applied only to the next call.</li>
|
|
88
|
-
<li><a href="#label-33">clear_tone_levels</a>
|
|
89
|
-
Clear tone levels set by <a href="#label-32">set_tone_levels</a>.</li>
|
|
90
|
-
<li><a href="#label-34">set_linear_tone_options</a>
|
|
91
|
-
Change the default option values regarding linear tone level
|
|
92
|
-
setting in <a href="#label-30">tone</a>.</li>
|
|
93
|
-
<li><a href="#label-35">next_linear_tone_options</a>
|
|
94
|
-
Similar to <a href="#label-34">set_linear_tone_options</a> but the setting
|
|
95
|
-
is effective only for the next call of <a href="#label-30">tone</a>.</li>
|
|
96
|
-
<li><a href="#label-38">vector</a> 2-D vector plot using DCL_Ext::<a href="#label-82">flow_vect</a></li>
|
|
97
|
-
</ul></li>
|
|
98
|
-
<li><a href="#label-39">module NumRu::DCLExt</a>
|
|
99
|
-
<ul>
|
|
100
|
-
<li><a href="#label-43">gl_set_params</a>
|
|
101
|
-
Calls <code>DCL.glpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
102
|
-
<li><a href="#label-45">sg_set_params</a>
|
|
103
|
-
Calls <code>DCL.sgpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
104
|
-
<li><a href="#label-47">sl_set_params</a>
|
|
105
|
-
Calls <code>DCL.slpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
106
|
-
<li><a href="#label-49">sw_set_params</a>
|
|
107
|
-
Calls <code>DCL.swpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
108
|
-
<li><a href="#label-51">uz_set_params</a>
|
|
109
|
-
Calls <code>DCL.uzpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
110
|
-
<li><a href="#label-53">ul_set_params</a>
|
|
111
|
-
Calls <code>DCL.ulpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
112
|
-
<li><a href="#label-55">uc_set_params</a>
|
|
113
|
-
Calls <code>DCL.ucpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
114
|
-
<li><a href="#label-57">uu_set_params</a>
|
|
115
|
-
Calls <code>DCL.uupset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
116
|
-
<li><a href="#label-59">us_set_params</a>
|
|
117
|
-
Calls <code>DCL.uspset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
118
|
-
<li><a href="#label-61">ud_set_params</a>
|
|
119
|
-
Calls <code>DCL.udpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
120
|
-
<li><a href="#label-62">ud_set_linear_levs</a>
|
|
121
|
-
Set contour levels with a constant interval</li>
|
|
122
|
-
<li><a href="#label-63">ud_set_contour</a>
|
|
123
|
-
Set contours of at specified levels.</li>
|
|
124
|
-
<li><a href="#label-64">ud_add_contour</a>
|
|
125
|
-
Same as <a href="#label-63">ud_set_contour</a>, but does not clear the contour levels that have
|
|
126
|
-
been set.</li>
|
|
127
|
-
<li><a href="#label-66">ue_set_params</a>
|
|
128
|
-
Calls <code>DCL.uepset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
129
|
-
<li><a href="#label-67">ue_set_linear_levs</a>
|
|
130
|
-
Set tone levels with a constant interval</li>
|
|
131
|
-
<li><a href="#label-68">ue_set_tone</a>
|
|
132
|
-
Set tone levels and patterns.</li>
|
|
133
|
-
<li><a href="#label-69">ue_add_tone</a>
|
|
134
|
-
Same as <a href="#label-68">ue_set_tone</a>, but does not clear the tone levels that have
|
|
135
|
-
been set.</li>
|
|
136
|
-
<li><a href="#label-71">ug_set_params</a>
|
|
137
|
-
Calls <code>DCL.ugpset</code> multiple times (for each key and val of <code>hash</code>).
|
|
138
|
-
See <a href="#label-43">gl_set_params</a> for usage.</li>
|
|
139
|
-
<li><a href="#label-73">um_set_params</a>
|
|
140
|
-
Calls <code>DCL.umpset</code> multiple times (for each key and val of <code>hash</code>).</li>
|
|
141
|
-
<li><a href="#label-76">lon_ax</a>
|
|
142
|
-
Draw longitude axis. (label format: degrees + 'E' or 'W')</li>
|
|
143
|
-
<li><a href="#label-77">lat_ax</a>
|
|
144
|
-
Draw latitude axis. (label format: degrees + 'N' or 'S')</li>
|
|
145
|
-
<li><a href="#label-79">unit_vect</a> Show the "unit vector", which indicate the vector scaling.</li>
|
|
146
|
-
<li><a href="#label-36">set_unit_vect_options</a>
|
|
147
|
-
Change the default option values for <a href="#label-79">unit_vect</a>.</li>
|
|
148
|
-
<li><a href="#label-37">next_unit_vect_options</a>
|
|
149
|
-
Set the option values effective only in the next call of <a href="#label-79">unit_vect</a></li>
|
|
150
|
-
<li><a href="#label-82">flow_vect</a> 2D Vector plot. Unlike <code>DCL::ugvect</code>, scaling are made in term of the physical (or "U") coordinate.</li>
|
|
151
|
-
<li><a href="#label-83">flow_itr5</a> 2D Vector plot on the 2-dim polar coodinate.</li>
|
|
152
|
-
<li><a href="#label-31">color_bar</a> Color Bar</li>
|
|
153
|
-
<li><a href="#label-88">legend</a>
|
|
154
|
-
Annotates line/mark type and index (and size if mark).</li>
|
|
155
|
-
<li><a href="#label-89">quasi_log_levels_z</a>
|
|
156
|
-
Driver of quasi_log_levels with data values</li>
|
|
157
|
-
<li><a href="#label-90">quasi_log_levels</a>
|
|
158
|
-
Returns approximately log-scaled contour/tone levels.</li>
|
|
159
|
-
</ul></li>
|
|
160
|
-
</ul>
|
|
161
|
-
<h1><a name="label-2" id="label-2">module NumRu::GGraph</a></h1><!-- RDLabel: "module NumRu::GGraph" -->
|
|
162
|
-
<p>A graphic library for GPhys using RubyDCL.</p>
|
|
163
|
-
<p>This module uses GPhys but is not a part of it.
|
|
164
|
-
More specifically, even though this module is included in
|
|
165
|
-
the GPhys distribution, the class NumRu::GPhys knows nothing about it,
|
|
166
|
-
and GGraph accesses GPhys only though public methods.
|
|
167
|
-
So GGraph is not an insider, and you can make another graphic
|
|
168
|
-
library if you like.</p>
|
|
169
|
-
<h2><a name="label-3" id="label-3">Module Functions</a></h2><!-- RDLabel: "Module Functions" -->
|
|
170
|
-
<dl>
|
|
171
|
-
<dt><h4><a name="label-4" id="label-4"><code>margin_info(<var>program</var>=<var>nil</var>, <var>data_source</var>=<var>nil</var>, <var>char_height</var>=<var>nil</var>, <var>date</var>=<var>nil</var>, <var>xl</var>=<var>0</var>.<var>0</var>, <var>xr</var>=<var>0</var>.<var>0</var>, <var>yb</var>=<var>nil</var>, <var>yt</var>=<var>0</var>.<var>0</var>)</code></a></h4></dt><!-- RDLabel: "margin_info" -->
|
|
172
|
-
<dd>
|
|
173
|
-
<p>Sets the strings to appear in the bottom margin.</p>
|
|
174
|
-
<p>This method sets margin widths as DCL.slmgn(xl, xr, yb, yt),
|
|
175
|
-
and sets the 1st and 2nd margin strings as <code>program</code>
|
|
176
|
-
and <code>data</code>.</p>
|
|
177
|
-
<p>ARGUMENTS</p>
|
|
178
|
-
<ul>
|
|
179
|
-
<li>program (String or nil) : String to be put on the left side in
|
|
180
|
-
the bottom margin. This is meant to represent the name of the
|
|
181
|
-
execution program. Therefore, if it is nil, the full path of
|
|
182
|
-
$0 is used.</li>
|
|
183
|
-
<li>data_source (String or nil) : String to be put on the right side in
|
|
184
|
-
the bottom margin. This is meant to represent the data file name or the
|
|
185
|
-
directory in which the data are situated.
|
|
186
|
-
If nil, the full path of the current directory is used
|
|
187
|
-
(but nothing is shown if it is equal to the directory of the program).</li>
|
|
188
|
-
<li>date (true, false, nil) : whether to put todays date --
|
|
189
|
-
true: always, nil: if program.length is short enough, false: never</li>
|
|
190
|
-
<li>char_height (Float or nil) : height of the string to appear
|
|
191
|
-
in the V coordinate. If nil, internally defined.</li>
|
|
192
|
-
<li>xl, xr, yb, yl (Float --- nil is available for yb) : margin
|
|
193
|
-
size in the V coordinate. The margin is set as
|
|
194
|
-
DCL.slmgn(xl, xr, yb, yt). If <code>yb</code> is nil, it is determined
|
|
195
|
-
internally as <code>2.0 * char_height</code>.</li>
|
|
196
|
-
</ul></dd>
|
|
197
|
-
<dt><h4><a name="label-5" id="label-5"><code>title(<var>string</var>)</code></a></h4></dt><!-- RDLabel: "title" -->
|
|
198
|
-
<dd>
|
|
199
|
-
<p>Shows title by <code>DCL.uxmttl('t',string,0.0)</code>.
|
|
200
|
-
Graphic methods such as <a href="#label-25">contour</a> calls this by default.</p>
|
|
201
|
-
<p>RETURN VALUE</p>
|
|
202
|
-
<ul>
|
|
203
|
-
<li>nil</li>
|
|
204
|
-
</ul></dd>
|
|
205
|
-
<dt><h4><a name="label-6" id="label-6"><code>annotate(<var>str_ary</var>)</code></a></h4></dt><!-- RDLabel: "annotate" -->
|
|
206
|
-
<dd>
|
|
207
|
-
<p>Show texts on the right margin of the viewport.
|
|
208
|
-
Graphic methods such as <a href="#label-25">contour</a> calls this by default.</p>
|
|
209
|
-
<p>ARGUMENTS</p>
|
|
210
|
-
<ul>
|
|
211
|
-
<li>str_ary (Array of String) :</li>
|
|
212
|
-
</ul>
|
|
213
|
-
<p>RETURN VALUE</p>
|
|
214
|
-
<ul>
|
|
215
|
-
<li>nil</li>
|
|
216
|
-
</ul></dd>
|
|
217
|
-
<dt><h4><a name="label-7" id="label-7"><code>fig(<var>xax</var>=<var>nil</var>, <var>yax</var>=<var>nil</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "fig" -->
|
|
218
|
-
<dd>
|
|
219
|
-
<p>Define a figure by setting viewport, window, and coordinate transform
|
|
220
|
-
id (itr) from two 1D VArrays <code>xax</code> and <code>yax</code> (which are
|
|
221
|
-
not needed if a map projection is specified with the optional
|
|
222
|
-
parameter 'itr').</p>
|
|
223
|
-
<p><code>DCL.grfrm</code> or <code>DCL.grfig</code> is called depending options provided.</p>
|
|
224
|
-
<p>ARGUMENTS</p>
|
|
225
|
-
<ul>
|
|
226
|
-
<li>xax (VArray): (Used only if not map projection)
|
|
227
|
-
A VArray representing the x (horizontal) coordinate
|
|
228
|
-
of the figure.
|
|
229
|
-
The x range of the window (UXMIN & UYMAX in DCL) are determined
|
|
230
|
-
with the max and min of <code>xax.val</code>. By default,
|
|
231
|
-
the min and max values are assigned to the left and right
|
|
232
|
-
boundaries, respectively, but it is reversed if <code>xax</code> has
|
|
233
|
-
a 'positive' attribute and its value is 'down' etc (see <code>options</code>).</li>
|
|
234
|
-
<li>yax (VArray): (Used only if not map projection)
|
|
235
|
-
Similar to <code>xax</code> but for the y (vertical) coordinate
|
|
236
|
-
of the figure.</li>
|
|
237
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
238
|
-
It is a Hash with option names (String) as keys and their values.
|
|
239
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
240
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
241
|
-
unambiguous.</p>
|
|
242
|
-
<pre>option name default value # description:
|
|
243
|
-
"new_frame" true # whether to define a new frame by DCL.grfrm
|
|
244
|
-
# (otherwise, DCL.grfig is called)
|
|
245
|
-
"no_new_fig" false # If true, neither DCL.grfrm nor DCL.grfig
|
|
246
|
-
# is called (overrides new_frame) -- Then, you need
|
|
247
|
-
# to call one of them in advance. Convenient to set
|
|
248
|
-
# DCL parameters that are reset by grfrm or grfig.
|
|
249
|
-
"itr" 1 # coordinate transformation number
|
|
250
|
-
"viewport" [0.2, 0.8, 0.2, 0.8] # [vxmin, vxmax, vymin, vymax]
|
|
251
|
-
"eqdistvpt" false # modify viewport to equidistant for x and y
|
|
252
|
-
# (only for itr=1--4)
|
|
253
|
-
"window" nil # (for itr<10,>50) [uxmin, uxmax, uymin, uymax],
|
|
254
|
-
# each element allowed nil (only for itr<5,>50)
|
|
255
|
-
"xreverse" "positive:down,units:hPa" # (for itr<10,>50) Assign
|
|
256
|
-
# max value to UXMIN and min value to UXMAX if
|
|
257
|
-
# condition is satisfied (nil:never, true:always,
|
|
258
|
-
# String: when an attibute has the value specified
|
|
259
|
-
# ("key:value,key:value,..")
|
|
260
|
-
"yreverse" "positive:down,units:hPa" # (for itr<10,>50) Assign
|
|
261
|
-
# max value to UYMIN and min value to UYMAX if
|
|
262
|
-
# condition is satisfied (nil:never, true:always,
|
|
263
|
-
# String: when an attibute has the value specified
|
|
264
|
-
# ("key:value,key:value,..")
|
|
265
|
-
"round0" false # expand window range to good numbers (effective
|
|
266
|
-
# only to internal window settings)
|
|
267
|
-
"round1" false # expand window range to good numbers (effective
|
|
268
|
-
# even when "window" is explicitly specified)
|
|
269
|
-
"similar" nil # (for rectangular curvilinear coordinate only)
|
|
270
|
-
# 3-element float array for similar transformation
|
|
271
|
-
# in a rectangular curvilinear coordinate, which
|
|
272
|
-
# is fed in DCL:grssim:[simfac,vxoff,vyoff],where
|
|
273
|
-
# simfac and [vxoff,vyoff] represent scaling
|
|
274
|
-
# factor and origin shift, respectively.
|
|
275
|
-
"map_axis" nil # (for all map projections) 3-element float
|
|
276
|
-
# array to be fed in DCL::umscnt: [uxc, uxy, rot],
|
|
277
|
-
# where [uxc, uyc] represents the tangential point
|
|
278
|
-
# (or the pole at top side for cylindrical
|
|
279
|
-
# projections), and rot represents the rotation
|
|
280
|
-
# angle. If nil, internally determined. (units:
|
|
281
|
-
# degrees)
|
|
282
|
-
"map_radius" nil # (for itr>=20: conical/azimuhal map
|
|
283
|
-
# projections) raidus around the tangential point.
|
|
284
|
-
# (units: degrees)
|
|
285
|
-
"map_fit" nil # (Only for itr=10(cylindrical) and 11 (Mercator))
|
|
286
|
-
# true: fit the plot to the data window
|
|
287
|
-
# (overrides map_window and map_axis); false: do
|
|
288
|
-
# not fit (then map_window and map_axis are used);
|
|
289
|
-
# nil: true if itr==10, false if itr==11
|
|
290
|
-
"map_rsat" nil # (Only for itr=30) satellite distance from the
|
|
291
|
-
# earth's center (Parameter "RSAT" for sgpack)
|
|
292
|
-
"map_window" [-180, 180, -75, 75] # (for itr<20: cylindrical
|
|
293
|
-
# map projections) lon-lat window [lon_min,
|
|
294
|
-
# lon_max, lat_min, lat_max ] to draw the map
|
|
295
|
-
# (units: degres)
|
|
296
|
-
"help" false # show help message if true</pre></li>
|
|
297
|
-
</ul>
|
|
298
|
-
<p>RETURN VALUE</p>
|
|
299
|
-
<ul>
|
|
300
|
-
<li>nil</li>
|
|
301
|
-
</ul>
|
|
302
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
303
|
-
<ul>
|
|
304
|
-
<li>those from NumRu::DCL if any / TypeError if any</li>
|
|
305
|
-
<li>options has a key that does not match any of the option names.</li>
|
|
306
|
-
<li>options has a key that is ambiguous</li>
|
|
307
|
-
</ul></dd>
|
|
308
|
-
<dt><h4><a name="label-8" id="label-8"><code>set_fig(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_fig" -->
|
|
309
|
-
<dd>
|
|
310
|
-
<p>Change the default option values for <a href="#label-7">fig</a>.</p>
|
|
311
|
-
<p>ARGUMENTS</p>
|
|
312
|
-
<ul>
|
|
313
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-7">fig</a>.</li>
|
|
314
|
-
</ul>
|
|
315
|
-
<p>RETURN VALUE</p>
|
|
316
|
-
<ul>
|
|
317
|
-
<li>a Hash containing the values replaced (the ones before calling this
|
|
318
|
-
method)</li>
|
|
319
|
-
</ul>
|
|
320
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
321
|
-
<ul>
|
|
322
|
-
<li>see <a href="#label-7">fig</a>.</li>
|
|
323
|
-
</ul></dd>
|
|
324
|
-
<dt><h4><a name="label-9" id="label-9"><code>next_fig(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_fig" -->
|
|
325
|
-
<dd>
|
|
326
|
-
<p>Set the option values effective only in the next call of <a href="#label-7">fig</a>
|
|
327
|
-
(cleared then).</p>
|
|
328
|
-
<p>These value are overwritten if specified explicitly in the next
|
|
329
|
-
call of <a href="#label-7">fig</a>.</p>
|
|
330
|
-
<p>ARGUMENTS</p>
|
|
331
|
-
<ul>
|
|
332
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-7">fig</a>.</li>
|
|
333
|
-
</ul>
|
|
334
|
-
<p>RETURN VALUE</p>
|
|
335
|
-
<ul>
|
|
336
|
-
<li>nil</li>
|
|
337
|
-
</ul>
|
|
338
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
339
|
-
<ul>
|
|
340
|
-
<li>see <a href="#label-7">fig</a>.</li>
|
|
341
|
-
</ul></dd>
|
|
342
|
-
<dt><h4><a name="label-10" id="label-10"><code>axes(<var>xax</var>=<var>nil</var>, <var>yax</var>=<var>nil</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "axes" -->
|
|
343
|
-
<dd>
|
|
344
|
-
<p>Draw axes using (by default) info in <code>xax</code> and <code>yax</code> if non-nil.</p>
|
|
345
|
-
<p>ARGUMENTS</p>
|
|
346
|
-
<ul>
|
|
347
|
-
<li>xax (nil or VArray): if non-nil, attributes 'long_name' and 'units'
|
|
348
|
-
are read to define <code>xtitle</code> and <code>xunits</code> (see below).
|
|
349
|
-
These are overwritten by explicitly specifying <code>xtitle</code> and
|
|
350
|
-
<code>xunits</code>.</li>
|
|
351
|
-
<li>yax (nil or VArray): if non-nil, attributes 'long_name' and 'units'
|
|
352
|
-
are read to define <code>ytitle</code> and <code>yunits</code> (see below).
|
|
353
|
-
These are overwritten by explicitly specifying <code>ytitle</code> and
|
|
354
|
-
<code>yunits</code>.</li>
|
|
355
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
356
|
-
It is a Hash with option names (String) as keys and their values.
|
|
357
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
358
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
359
|
-
unambiguous.</p>
|
|
360
|
-
<pre>option name default value # description:
|
|
361
|
-
"xside" "tb" # Where to draw xaxes (combination of t, b and u)
|
|
362
|
-
"yside" "lr" # Where to draw yaxes (combination of l, r and u)
|
|
363
|
-
"xtitle" nil # Title of x axis (if nil, internally determined)
|
|
364
|
-
"ytitle" nil # Title of y axis (if nil, internally determined)
|
|
365
|
-
"xunits" nil # Units of x axis (if nil, internally determined)
|
|
366
|
-
"yunits" nil # Units of y axis (if nil, internally determined)
|
|
367
|
-
"xtickint" nil # Interval of x axis tickmark
|
|
368
|
-
# (if nil, internally determined)
|
|
369
|
-
"ytickint" nil # Interval of y axis tickmark
|
|
370
|
-
# (if nil, internally determined)
|
|
371
|
-
"xlabelint" nil # Interval of x axis label
|
|
372
|
-
# (if nil, internally determined)
|
|
373
|
-
"ylabelint" nil # Interval of y axis label
|
|
374
|
-
# (if nil, internally determined)
|
|
375
|
-
"xmaplabel" nil # If "lon"("lat"), use
|
|
376
|
-
# DCLExt::lon_ax(DCLExt::lat_ax) to draw xaxes;
|
|
377
|
-
# otherwise, DCL::usxaxs is used.
|
|
378
|
-
"ymaplabel" nil # If "lon"("lat"), use
|
|
379
|
-
# DCLExt::lon_ax(DCLExt::lat_ax) to draw yaxes;
|
|
380
|
-
# otherwise, DCL::usyaxs is used.
|
|
381
|
-
"time_ax" nil # Type of calendar-type time axis: nil (=> auto
|
|
382
|
-
# slection), false (do not use the time axis even
|
|
383
|
-
# if the units of the axis is a time one with since
|
|
384
|
-
# field), "h" (=> like nil, but always use the
|
|
385
|
-
# hour-resolving datetime_ax method in
|
|
386
|
-
# dclext_datetime_ax.rb), or "ymd" (=> like "h" but
|
|
387
|
-
# for y-m-d type using DCL.uc[xy]acl)
|
|
388
|
-
"help" false # show help message if true</pre></li>
|
|
389
|
-
</ul>
|
|
390
|
-
<p>RETURN VALUE</p>
|
|
391
|
-
<ul>
|
|
392
|
-
<li>nil</li>
|
|
393
|
-
</ul>
|
|
394
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
395
|
-
<ul>
|
|
396
|
-
<li>those from NumRu::DCL if any / TypeError if any</li>
|
|
397
|
-
<li>options has a key that does not match any of the option names.</li>
|
|
398
|
-
<li>options has a key that is ambiguous</li>
|
|
399
|
-
</ul></dd>
|
|
400
|
-
<dt><h4><a name="label-11" id="label-11"><code>set_axes(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_axes" -->
|
|
401
|
-
<dd>
|
|
402
|
-
<p>Change the default option values for <a href="#label-10">axes</a>.</p>
|
|
403
|
-
<p>ARGUMENTS</p>
|
|
404
|
-
<ul>
|
|
405
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-10">axes</a>.</li>
|
|
406
|
-
</ul>
|
|
407
|
-
<p>RETURN VALUE</p>
|
|
408
|
-
<ul>
|
|
409
|
-
<li>a Hash containing the values replaced (the ones before calling this
|
|
410
|
-
method)</li>
|
|
411
|
-
</ul>
|
|
412
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
413
|
-
<ul>
|
|
414
|
-
<li>see <a href="#label-10">axes</a>.</li>
|
|
415
|
-
</ul></dd>
|
|
416
|
-
<dt><h4><a name="label-12" id="label-12"><code>next_axes(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_axes" -->
|
|
417
|
-
<dd>
|
|
418
|
-
<p>Set the option values effective only in the next call of <a href="#label-10">axes</a>
|
|
419
|
-
(cleared then).</p>
|
|
420
|
-
<p>These value are overwritten if specified explicitly in the next
|
|
421
|
-
call of <a href="#label-10">axes</a>.</p>
|
|
422
|
-
<p>ARGUMENTS</p>
|
|
423
|
-
<ul>
|
|
424
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-10">axes</a>.</li>
|
|
425
|
-
</ul>
|
|
426
|
-
<p>RETURN VALUE</p>
|
|
427
|
-
<ul>
|
|
428
|
-
<li>nil</li>
|
|
429
|
-
</ul>
|
|
430
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
431
|
-
<ul>
|
|
432
|
-
<li>see <a href="#label-10">axes</a>.</li>
|
|
433
|
-
</ul></dd>
|
|
434
|
-
<dt><h4><a name="label-13" id="label-13"><code>sim_trn?</code></a></h4></dt><!-- RDLabel: "sim_trn?" -->
|
|
435
|
-
<dd>
|
|
436
|
-
<p>Returns whether the current coordinate transformation is a rectangular
|
|
437
|
-
curvelinear coordinate. A coordinate transformation must have been
|
|
438
|
-
established with <a href="#label-7">fig</a> or <code>DCL::grstrf</code>.
|
|
439
|
-
Mainly for internal usage, but a user can use it too.</p>
|
|
440
|
-
<p>RETURN VALUE</p>
|
|
441
|
-
<ul>
|
|
442
|
-
<li>true or false</li>
|
|
443
|
-
</ul></dd>
|
|
444
|
-
<dt><h4><a name="label-14" id="label-14"><code>polar_coordinate_boundaries(<var>xax</var>=<var>nil</var>,<var>yax</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "polar_coordinate_boundaries" -->
|
|
445
|
-
<dd>
|
|
446
|
-
<p>Draw boundaries in a polar coordinate.</p>
|
|
447
|
-
<p>ARGUMENTS</p>
|
|
448
|
-
<ul>
|
|
449
|
-
<li>xax (VArray): Grid points of the radial coordinate.</li>
|
|
450
|
-
<li>yax (VArray): Grid points of the azimuthal coordinate.</li>
|
|
451
|
-
</ul>
|
|
452
|
-
<p>RETURN VALUE</p>
|
|
453
|
-
<ul>
|
|
454
|
-
<li>nil</li>
|
|
455
|
-
</ul></dd>
|
|
456
|
-
<dt><h4><a name="label-15" id="label-15"><code>map_trn?</code></a></h4></dt><!-- RDLabel: "map_trn?" -->
|
|
457
|
-
<dd>
|
|
458
|
-
<p>Returns whether the current coordinate transformation is a map projection.</p>
|
|
459
|
-
<p>A coordinate transformation must have been established
|
|
460
|
-
with <a href="#label-7">fig</a> or <code>DCL::grstrf</code>.
|
|
461
|
-
Mainly for internal usage, but a user can use it too.</p>
|
|
462
|
-
<p>RETURN VALUE</p>
|
|
463
|
-
<ul>
|
|
464
|
-
<li>true or false</li>
|
|
465
|
-
</ul></dd>
|
|
466
|
-
<dt><h4><a name="label-16" id="label-16"><code>map(<var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "map" -->
|
|
467
|
-
<dd>
|
|
468
|
-
<p>(For map projection) Draws map grid and/or lim and/or coast lines etc.</p>
|
|
469
|
-
<p>ARGUMENTS</p>
|
|
470
|
-
<ul>
|
|
471
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
472
|
-
It is a Hash with option names (String) as keys and their values.
|
|
473
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
474
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
475
|
-
unambiguous.</p>
|
|
476
|
-
<pre>option name default value # description:
|
|
477
|
-
"lim" true # draw map lim (t or f)
|
|
478
|
-
"grid" true # draw map grid (t or f)
|
|
479
|
-
"vpt_boundary" false # draw viewport boundaries (f, t or
|
|
480
|
-
# 1,2,3.., representing the line width)
|
|
481
|
-
"wwd_boundary" false # draw worksation window boundaries (f, t
|
|
482
|
-
# or 1,2,3.., representing the line width)
|
|
483
|
-
"fill" false # fill the map if coast_world or coast_japan is
|
|
484
|
-
# true (t or f)
|
|
485
|
-
"coast_world" false # draw world coast lines (t or f)
|
|
486
|
-
"border_world" false # draw nation borders (t or f)
|
|
487
|
-
"plate_world" false # draw plate boundaries (t or f)
|
|
488
|
-
"state_usa" false # draw state boundaries of US (t or f)
|
|
489
|
-
"coast_japan" false # draw japanese coast lines (t or f)
|
|
490
|
-
"pref_japan" false # draw japanese prefecture boundaries (t or
|
|
491
|
-
# f)
|
|
492
|
-
"dgridmj" nil # the interval between the major lines of
|
|
493
|
-
# latitudes and longitudes. If nil, internally
|
|
494
|
-
# determined. (units: degrees) (this is a UMPACK
|
|
495
|
-
# parameter, which is nullified when uminit or
|
|
496
|
-
# grfrm is called)
|
|
497
|
-
"dgridmn" nil # the interval between the minor lines of
|
|
498
|
-
# latitudes and longitudes. If nil, internally
|
|
499
|
-
# determined. (units: degrees) (this is a UMPACK
|
|
500
|
-
# parameter, which is nullified when uminit or
|
|
501
|
-
# grfrm is called)
|
|
502
|
-
"help" false # show help message if true</pre></li>
|
|
503
|
-
</ul>
|
|
504
|
-
<p>RETURN VALUE</p>
|
|
505
|
-
<ul>
|
|
506
|
-
<li>nil</li>
|
|
507
|
-
</ul>
|
|
508
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
509
|
-
<ul>
|
|
510
|
-
<li>if called when the coordinate tansformation has not been established or
|
|
511
|
-
the transformation is not a map projection.</li>
|
|
512
|
-
<li>those from NumRu::DCL if any / TypeError if any</li>
|
|
513
|
-
<li>options has a key that does not match any of the option names.</li>
|
|
514
|
-
<li>options has a key that is ambiguous</li>
|
|
515
|
-
</ul></dd>
|
|
516
|
-
<dt><h4><a name="label-17" id="label-17"><code>set_map(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_map" -->
|
|
517
|
-
<dd>
|
|
518
|
-
<p>Change the default option values for <a href="#label-16">map</a>.</p>
|
|
519
|
-
<p>ARGUMENTS</p>
|
|
520
|
-
<ul>
|
|
521
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-16">map</a>.</li>
|
|
522
|
-
</ul>
|
|
523
|
-
<p>RETURN VALUE</p>
|
|
524
|
-
<ul>
|
|
525
|
-
<li>a Hash containing the values replaced (the ones before calling this
|
|
526
|
-
method)</li>
|
|
527
|
-
</ul>
|
|
528
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
529
|
-
<ul>
|
|
530
|
-
<li>see <a href="#label-16">map</a>.</li>
|
|
531
|
-
</ul></dd>
|
|
532
|
-
<dt><h4><a name="label-18" id="label-18"><code>next_map(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_map" -->
|
|
533
|
-
<dd>
|
|
534
|
-
<p>Set the option values effective only in the next call of <a href="#label-16">map</a>
|
|
535
|
-
(cleared then).</p>
|
|
536
|
-
<p>These value are overwritten if specified explicitly in the next
|
|
537
|
-
call of <a href="#label-16">map</a>.</p>
|
|
538
|
-
<p>ARGUMENTS</p>
|
|
539
|
-
<ul>
|
|
540
|
-
<li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-16">map</a>.</li>
|
|
541
|
-
</ul>
|
|
542
|
-
<p>RETURN VALUE</p>
|
|
543
|
-
<ul>
|
|
544
|
-
<li>nil</li>
|
|
545
|
-
</ul>
|
|
546
|
-
<p>POSSIBLE EXCEPTIONS</p>
|
|
547
|
-
<ul>
|
|
548
|
-
<li>see <a href="#label-16">map</a>.</li>
|
|
549
|
-
</ul></dd>
|
|
550
|
-
<dt><h4><a name="label-19" id="label-19"><code>line(<var>gphys</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "line" -->
|
|
551
|
-
<dd>
|
|
552
|
-
<p>Plot a poly-line by selecting the first dimension (with GPhys#first1D)
|
|
553
|
-
if <code>gphys</code> is more than 2D.</p>
|
|
554
|
-
<p>ARGUMENTS</p>
|
|
555
|
-
<ul>
|
|
556
|
-
<li>gphys (GPhys) : a GPhys whose data is plotted.</li>
|
|
557
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
|
|
558
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
559
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
560
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
561
|
-
It is a Hash with option names (String) as keys and their values.
|
|
562
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
563
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
564
|
-
unambiguous.</p>
|
|
565
|
-
<pre>option name default value # description:
|
|
566
|
-
"title" nil # Title of the figure(if nil, internally
|
|
567
|
-
# determined)
|
|
568
|
-
"annotate" true # if false, do not put texts on the right
|
|
569
|
-
# margin even when newframe==true
|
|
570
|
-
"exchange" false # whether to exchange x and y axes
|
|
571
|
-
"index" 1 # line/mark index
|
|
572
|
-
"type" 1 # line type
|
|
573
|
-
"label" nil # if a String is given, it is shown as the label
|
|
574
|
-
"max" nil # maximum data value
|
|
575
|
-
"min" nil # minimum data value
|
|
576
|
-
"legend" nil # legend to annotate the line type and index. nil
|
|
577
|
-
# (defalut -- do not show); a String as the legend;
|
|
578
|
-
# true to use the name of the GPhys as the legend
|
|
579
|
-
"legend_vx" nil # (effective if legend) viewport x values of
|
|
580
|
-
# the lhs of the legend line (positive float); or
|
|
581
|
-
# nil for automatic settting (shown to the right of
|
|
582
|
-
# vpt); or move it to the left relatively (negtive
|
|
583
|
-
# float)
|
|
584
|
-
"legend_dx" nil # (effective if legend) length of the legend
|
|
585
|
-
# line
|
|
586
|
-
"legend_vy" nil # (effective if legend) viewport y value of the
|
|
587
|
-
# legend (Float; or nil for automatic settting)
|
|
588
|
-
"legend_size" nil # (effective if legend) character size of the
|
|
589
|
-
# legend
|
|
590
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
591
|
-
# true, draws axes by temprarilly switching to
|
|
592
|
-
# itr=1 and calling GGraph::axes.
|
|
593
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
594
|
-
# subset the data before plotting (order applied:
|
|
595
|
-
# slice -> cut -> mean)
|
|
596
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
597
|
-
# method to subset the data before plotting (order
|
|
598
|
-
# applied: slice -> cut -> mean)
|
|
599
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
600
|
-
# take mean of the data before plotting (order
|
|
601
|
-
# applied: slice -> cut -> mean)
|
|
602
|
-
"help" false # show help message if true</pre></li>
|
|
603
|
-
</ul>
|
|
604
|
-
<p>RETURN VALUE</p>
|
|
605
|
-
<ul>
|
|
606
|
-
<li>nil</li>
|
|
607
|
-
</ul></dd>
|
|
608
|
-
<dt><h4><a name="label-20" id="label-20"><code>mark(<var>gphys</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "mark" -->
|
|
609
|
-
<dd>
|
|
610
|
-
<p>Similar to <a href="#label-19">line</a> but plots marks instead of drawing a poly-line.</p>
|
|
611
|
-
<p>ARGUMENTS</p>
|
|
612
|
-
<ul>
|
|
613
|
-
<li>gphys (GPhys) : a GPhys whose data is plotted.</li>
|
|
614
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
|
|
615
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
616
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
617
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
618
|
-
It is a Hash with option names (String) as keys and their values.
|
|
619
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
620
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
621
|
-
unambiguous.</p>
|
|
622
|
-
<pre>option name default value # description:
|
|
623
|
-
"title" nil # Title of the figure(if nil, internally
|
|
624
|
-
# determined)
|
|
625
|
-
"annotate" true # if false, do not put texts on the right
|
|
626
|
-
# margin even when newframe==true
|
|
627
|
-
"exchange" false # whether to exchange x and y axes
|
|
628
|
-
"index" 1 # mark index
|
|
629
|
-
"type" 2 # mark type
|
|
630
|
-
"size" 0.01 # marks size
|
|
631
|
-
"max" nil # maximum data value
|
|
632
|
-
"min" nil # minimum data value
|
|
633
|
-
"legend" nil # legend to annotate the mark type, index, and
|
|
634
|
-
# size. nil (defalut -- do not to show); a String
|
|
635
|
-
# as the legend; true to use the name of the GPhys
|
|
636
|
-
# as the legend
|
|
637
|
-
"legend_vx" nil # (effective if legend) viewport x values of
|
|
638
|
-
# the lhs of the legend line (positive float); or
|
|
639
|
-
# nil for automatic settting (shown to the right of
|
|
640
|
-
# vpt); or move it to the left relatively (negtive
|
|
641
|
-
# float)
|
|
642
|
-
"legend_vy" nil # (effective if legend) viewport y value of the
|
|
643
|
-
# legend (Float; or nil for automatic settting)
|
|
644
|
-
"legend_size" nil # (effective if legend) character size of the
|
|
645
|
-
# legend
|
|
646
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
647
|
-
# true, draws axes by temprarilly switching to
|
|
648
|
-
# itr=1 and calling GGraph::axes.
|
|
649
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
650
|
-
# subset the data before plotting (order applied:
|
|
651
|
-
# slice -> cut -> mean)
|
|
652
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
653
|
-
# method to subset the data before plotting (order
|
|
654
|
-
# applied: slice -> cut -> mean)
|
|
655
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
656
|
-
# take mean of the data before plotting (order
|
|
657
|
-
# applied: slice -> cut -> mean)
|
|
658
|
-
"help" false # show help message if true</pre></li>
|
|
659
|
-
</ul>
|
|
660
|
-
<p>RETURN VALUE</p>
|
|
661
|
-
<ul>
|
|
662
|
-
<li>nil</li>
|
|
663
|
-
</ul></dd>
|
|
664
|
-
<dt><h4><a name="label-21" id="label-21"><code>scatter(<var>fx</var>, <var>fy</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "scatter" -->
|
|
665
|
-
<dd>
|
|
666
|
-
<p>Scatter diagram (using uumrkz, as in <a href="#label-20">mark</a>).</p>
|
|
667
|
-
<p>ARGUMENTS</p>
|
|
668
|
-
<ul>
|
|
669
|
-
<li>fx, fy (GPhys) : x and y locations.</li>
|
|
670
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
|
|
671
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
672
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
673
|
-
<li><p>options (Hash) : options to change the default behavior if specified.</p>
|
|
674
|
-
<pre>option name default value # description:
|
|
675
|
-
"title" "" # Title of the figure(if nil, internally determined)
|
|
676
|
-
"annotate" true # if false, do not put texts on the right
|
|
677
|
-
# margin even when newframe==true
|
|
678
|
-
"index" 1 # mark index
|
|
679
|
-
"type" 2 # mark type
|
|
680
|
-
"size" 0.01 # marks size
|
|
681
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
682
|
-
# true, draws axes by temprarilly switching to
|
|
683
|
-
# itr=1 and calling GGraph::axes.
|
|
684
|
-
"xintv" 1 # interval of data sampling in x
|
|
685
|
-
"yintv" 1 # interval of data sampling in y
|
|
686
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
687
|
-
# subset the data before plotting (order applied:
|
|
688
|
-
# slice -> cut -> mean)
|
|
689
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
690
|
-
# method to subset the data before plotting (order
|
|
691
|
-
# applied: slice -> cut -> mean)
|
|
692
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
693
|
-
# take mean of the data before plotting (order
|
|
694
|
-
# applied: slice -> cut -> mean)
|
|
695
|
-
"help" false # show help message if true</pre></li>
|
|
696
|
-
</ul></dd>
|
|
697
|
-
<dt><h4><a name="label-22" id="label-22"><code>color_scatter(<var>fx</var>, <var>fy</var>, <var>fz</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "color_scatter" -->
|
|
698
|
-
<dd>
|
|
699
|
-
<p>Scatter diagram colored by values.</p>
|
|
700
|
-
<p>Coloring is made with respoect to fz just like in (<<tone>>).
|
|
701
|
-
You can draw a color bar by calling (<<color_bar>>) after calling
|
|
702
|
-
this method.</p>
|
|
703
|
-
<p>ARGUMENTS</p>
|
|
704
|
-
<ul>
|
|
705
|
-
<li>fx, fy (GPhys) : x and y locations.</li>
|
|
706
|
-
<li>fz (GPhys) : value on which colors are based.</li>
|
|
707
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
|
|
708
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
709
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
710
|
-
<li><p>options (Hash) : options to change the default behavior if specified.</p>
|
|
711
|
-
<pre>option name default value # description:
|
|
712
|
-
"title" "" # Title of the figure(if nil, internally determined)
|
|
713
|
-
"annotate" true # if false, do not put texts on the right
|
|
714
|
-
# margin even when newframe==true
|
|
715
|
-
"index" 3 # mark index (1-9)
|
|
716
|
-
"type" 10 # mark type
|
|
717
|
-
"size" 0.01 # marks size
|
|
718
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
719
|
-
# true, draws axes by temprarilly switching to
|
|
720
|
-
# itr=1 and calling GGraph::axes.
|
|
721
|
-
"clr_min" nil # if an integer (in 10..99) is specified, used as
|
|
722
|
-
# the color number for the minimum data values.
|
|
723
|
-
# (the same can be done by setting the uepack
|
|
724
|
-
# parameter "icolor1")
|
|
725
|
-
"clr_max" nil # if an integer (in 10..99) is specified, used as
|
|
726
|
-
# the color number for the maximum data values.
|
|
727
|
-
# (the same can be done by setting the uepack
|
|
728
|
-
# parameter "icolor2")
|
|
729
|
-
"keep" false # Use the tone levels and patterns used previously
|
|
730
|
-
"min" nil # minimum tone level
|
|
731
|
-
"max" nil # maximum tone level
|
|
732
|
-
"nlev" nil # number of levels
|
|
733
|
-
"interval" nil # contour interval
|
|
734
|
-
"help" false # show help message if true
|
|
735
|
-
"log" nil # approximately log-scaled levels (by using
|
|
736
|
-
# DCLExt::quasi_log_levels)
|
|
737
|
-
"log_cycle" 3 # (if log) number of levels in one-order (1 or 2
|
|
738
|
-
# or 3)
|
|
739
|
-
"levels" nil # tone levels (Array/NArray of Numeric). Works
|
|
740
|
-
# together with patterns
|
|
741
|
-
"patterns" nil # Similar to the pattern option in (<<tone>>)),
|
|
742
|
-
# but here only the color part (4th and 5th
|
|
743
|
-
# digitgs) is used. -- e.g, pattern 38999
|
|
744
|
-
# --> color 38.
|
|
745
|
-
"xintv" 1 # interval of data sampling in x
|
|
746
|
-
"yintv" 1 # interval of data sampling in y
|
|
747
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
748
|
-
# subset the data before plotting (order applied:
|
|
749
|
-
# slice -> cut -> mean)
|
|
750
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
751
|
-
# method to subset the data before plotting (order
|
|
752
|
-
# applied: slice -> cut -> mean)
|
|
753
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
754
|
-
# take mean of the data before plotting (order
|
|
755
|
-
# applied: slice -> cut -> mean)
|
|
756
|
-
"help" false # show help message if true</pre></li>
|
|
757
|
-
</ul></dd>
|
|
758
|
-
<dt><h4><a name="label-23" id="label-23"><code>add_mode_vectors(<var>mean</var>, <var>modes</var>, <var>options</var>)</code></a></h4></dt><!-- RDLabel: "add_mode_vectors" -->
|
|
759
|
-
<dd>
|
|
760
|
-
<p>This method overlays mode vectors on scatter plots.
|
|
761
|
-
Call this method after scatter / color_scatter.</p>
|
|
762
|
-
<p>ARGUMENTS</p>
|
|
763
|
-
<ul>
|
|
764
|
-
<li>mean : this determines the center of vectors</li>
|
|
765
|
-
<li><p>modes : two dimensional mode vectors (e.g. EOF modes) of the shape [2,2], [2,1], or [2].</p>
|
|
766
|
-
<pre>the first mode is modes[true,0] and the second mode is modes[true,1].</pre></li>
|
|
767
|
-
<li><p>options (Hash) : options to change the default behavior if specified.</p>
|
|
768
|
-
<pre>option name default value # description:
|
|
769
|
-
'lineindex' 1 # line index
|
|
770
|
-
'linetype' 1 # line type
|
|
771
|
-
'fact' 2 # scaling factor (line length = stddev * fact for each side)
|
|
772
|
-
'style' 'line' # style of displaying modes (line, arrow, ellipse)</pre></li>
|
|
773
|
-
</ul></dd>
|
|
774
|
-
<dt><h4><a name="label-24" id="label-24"><code>tone_and_contour(<var>gphys</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "tone_and_contour" -->
|
|
775
|
-
<dd>
|
|
776
|
-
<p>Calls <a href="#label-30">tone</a> and <a href="#label-25">contour</a> successively. You can
|
|
777
|
-
specify the options for any of these.</p>
|
|
778
|
-
<p>NOTE:</p>
|
|
779
|
-
<ul>
|
|
780
|
-
<li>The option keys that are not existent in these methods
|
|
781
|
-
are simply neglected -- thus no spell-check-like feedback
|
|
782
|
-
is made, contrary to the indivisual call of contour or tone.
|
|
783
|
-
Also, only the help menu of <a href="#label-30">tone</a> can be shown.</li>
|
|
784
|
-
<li>Requires numru-misc-0.0.6 or later.</li>
|
|
785
|
-
</ul></dd>
|
|
786
|
-
<dt><h4><a name="label-25" id="label-25"><code>contour(<var>gphys</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "contour" -->
|
|
787
|
-
<dd>
|
|
788
|
-
<p>Contour plot by selecting the first 2 dimensions (with GPhys#first2D)
|
|
789
|
-
if <code>gphys</code> is more than 3D.</p>
|
|
790
|
-
<p>Contour levels are determined as follows:</p>
|
|
791
|
-
<ul>
|
|
792
|
-
<li>contour levels are set in this method if not set by
|
|
793
|
-
<a href="#label-26">set_contour_levels</a> or the option <code>"levels"</code> is specified
|
|
794
|
-
explicitly.</li>
|
|
795
|
-
<li>When contour levels are set in this method, the option <code>"levels"</code>
|
|
796
|
-
has the highest precedence. If it is specified, options
|
|
797
|
-
<code>"index"</code>, <code>"line_type"</code>, <code>"label"</code>, and <code>"label_height"</code>
|
|
798
|
-
are used.
|
|
799
|
-
If <code>"levels"</code> are not specified, contour levels with a linear
|
|
800
|
-
increment are set by using the options <code>"min"</code>, <code>"max"</code>,
|
|
801
|
-
<code>"nlev"</code>, <code>"interval"</code>, <code>"nozero"</code>, <code>"coloring"</code>,
|
|
802
|
-
<code>"clr_min"</code>, and <code>"clr_max"</code>, which are interpreted by
|
|
803
|
-
DCLExt::<a href="#label-62">ud_set_linear_levs</a>. The default values
|
|
804
|
-
of the linear level setting can be changed with
|
|
805
|
-
<a href="#label-28">set_linear_contour_options</a>.</li>
|
|
806
|
-
</ul>
|
|
807
|
-
<p>ARGUMENTS</p>
|
|
808
|
-
<ul>
|
|
809
|
-
<li>gphys (GPhys) : a GPhys whose data is plotted.</li>
|
|
810
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a> (or <a href="#label-16">map</a>),
|
|
811
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
812
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
813
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
814
|
-
It is a Hash with option names (String) as keys and their values.
|
|
815
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
816
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
817
|
-
unambiguous.</p>
|
|
818
|
-
<pre>option name default value # description:
|
|
819
|
-
"title" nil # Title of the figure(if nil, internally
|
|
820
|
-
# determined)
|
|
821
|
-
"annotate" true # if false, do not put texts on the right
|
|
822
|
-
# margin even when newframe==true
|
|
823
|
-
"transpose" false # if true, exchange x and y axes
|
|
824
|
-
"exchange" false # same as the option transpose
|
|
825
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
826
|
-
# true, draws axes by temprarilly switching to
|
|
827
|
-
# itr=1 and calling GGraph::axes.
|
|
828
|
-
"keep" false # Use the contour levels used previously
|
|
829
|
-
"min" nil # minimum contour level
|
|
830
|
-
"max" nil # maximum contour level
|
|
831
|
-
"nlev" nil # number of levels
|
|
832
|
-
"interval" nil # contour interval
|
|
833
|
-
"nozero" nil # delete zero contour
|
|
834
|
-
"coloring" false # set color contours with ud_coloring
|
|
835
|
-
"clr_min" 13 # (if coloring) minimum color number for the
|
|
836
|
-
# minimum data values
|
|
837
|
-
"clr_max" 99 # (if coloring) maximum color number for the
|
|
838
|
-
# maximum data values
|
|
839
|
-
"help" false # show help message if true
|
|
840
|
-
"log" nil # approximately log-scaled levels (by using
|
|
841
|
-
# DCLExt::quasi_log_levels)
|
|
842
|
-
"log_cycle" 3 # (if log) number of levels in one-order (1 or 2
|
|
843
|
-
# or 3)
|
|
844
|
-
"levels" nil # contour levels (Array/NArray of Numeric)
|
|
845
|
-
"index" nil # (if levels) line index(es) (Array/NArray of
|
|
846
|
-
# integers, Integer, or nil)
|
|
847
|
-
"line_type" nil # (if levels) line type(s) (Array/NArray of
|
|
848
|
-
# integers, Integer, or nil)
|
|
849
|
-
"label" nil # (if levels) contour label(s) (Array/NArray of
|
|
850
|
-
# String, String, true, false, nil). nil is
|
|
851
|
-
# recommended.
|
|
852
|
-
"label_height" nil # (if levels) label height(s)
|
|
853
|
-
# (Array/NArray of Numeric, Numeric, or nil).
|
|
854
|
-
# nil is recommended.
|
|
855
|
-
"xintv" 1 # interval of data sampling in x
|
|
856
|
-
"yintv" 1 # interval of data sampling in y
|
|
857
|
-
"xcoord" nil # Name of the coordinate variable for x-axis
|
|
858
|
-
"ycoord" nil # Name of the coordinate variable for y-axis
|
|
859
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
860
|
-
# subset the data before plotting (order applied:
|
|
861
|
-
# slice -> cut -> mean)
|
|
862
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
863
|
-
# method to subset the data before plotting (order
|
|
864
|
-
# applied: slice -> cut -> mean)
|
|
865
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
866
|
-
# take mean of the data before plotting (order
|
|
867
|
-
# applied: slice -> cut -> mean)</pre></li>
|
|
868
|
-
</ul>
|
|
869
|
-
<p>RETURN VALUE</p>
|
|
870
|
-
<ul>
|
|
871
|
-
<li>nil</li>
|
|
872
|
-
</ul></dd>
|
|
873
|
-
<dt><h4><a name="label-26" id="label-26"><code>set_contour_levels(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_contour_levels" -->
|
|
874
|
-
<dd>
|
|
875
|
-
<p>Set contour levels for <a href="#label-25">contour</a> explicitly by values with the option <code>levels</code>.</p>
|
|
876
|
-
<p>ARGUMENTS</p>
|
|
877
|
-
<ul>
|
|
878
|
-
<li>options (Hash) : options to change the default behavior.
|
|
879
|
-
The option <code>"levels"</code> is mandatory (so it is not optional!).
|
|
880
|
-
Supported options are <code>"levels"</code>, <code>"index"</code>,
|
|
881
|
-
<code>"line_type"</code>, <code>"label"</code>, and <code>"label_height"</code>.
|
|
882
|
-
See <a href="#label-25">contour</a> for their description.</li>
|
|
883
|
-
</ul></dd>
|
|
884
|
-
<dt><h4><a name="label-27" id="label-27"><code>clear_contour_levels</code></a></h4></dt><!-- RDLabel: "clear_contour_levels" -->
|
|
885
|
-
<dd>
|
|
886
|
-
Clear contour levels set by <a href="#label-26">set_contour_levels</a>.</dd>
|
|
887
|
-
<dt><h4><a name="label-28" id="label-28"><code>set_linear_contour_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_linear_contour_options" -->
|
|
888
|
-
<dd>
|
|
889
|
-
<p>Change the default option values regarding linear contour level
|
|
890
|
-
setting in <a href="#label-25">contour</a>.</p>
|
|
891
|
-
<p>ARGUMENTS</p>
|
|
892
|
-
<ul>
|
|
893
|
-
<li>options (Hash) : The usage is the same as <code>options</code>
|
|
894
|
-
for <a href="#label-25">contour</a> but supported options here are limited to
|
|
895
|
-
<code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, <code>"interval"</code>,
|
|
896
|
-
<code>"nozero"</code>, <code>"coloring"</code>, <code>"clr_min"</code>, and <code>"clr_max"</code>.</li>
|
|
897
|
-
</ul>
|
|
898
|
-
<p>RETURN VALUE</p>
|
|
899
|
-
<ul>
|
|
900
|
-
<li>a Hash containing the values replaced (the ones before calling this
|
|
901
|
-
method)</li>
|
|
902
|
-
</ul></dd>
|
|
903
|
-
<dt><h4><a name="label-29" id="label-29"><code>next_linear_contour_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_linear_contour_options" -->
|
|
904
|
-
<dd>
|
|
905
|
-
Similar to <a href="#label-28">set_linear_contour_options</a> but the setting
|
|
906
|
-
is effective only for the next call of <a href="#label-25">contour</a>.</dd>
|
|
907
|
-
<dt><h4><a name="label-30" id="label-30"><code>tone(<var>gphys</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "tone" -->
|
|
908
|
-
<dd>
|
|
909
|
-
<p>Color tone or shading by selecting the first 2 dimensions
|
|
910
|
-
(with GPhys#first2D) if <code>gphys</code> is more than 3D.</p>
|
|
911
|
-
<p>Tone levels are determined as follows:</p>
|
|
912
|
-
<ul>
|
|
913
|
-
<li>Tone levels are set in this method if not set by
|
|
914
|
-
<a href="#label-32">set_tone_levels</a> or the option <code>"levels"</code> (and
|
|
915
|
-
optionally, <code>"patterns"</code>) is (are) specified explicitly.</li>
|
|
916
|
-
<li>When contour levels & patterns are set in this method,
|
|
917
|
-
<ul>
|
|
918
|
-
<li><code>"levels"</code> has the highest precedence. If it is specified,
|
|
919
|
-
tone levels and patterns are determined by DCLExt::<a href="#label-68">ue_set_tone</a>.
|
|
920
|
-
Here, tone patterns can be specified with the option <code>"patterns"</code>.</li>
|
|
921
|
-
<li>Currently, option <code>"patterns"</code> is effective only if <code>"levels"</code>
|
|
922
|
-
is specified. Otherwise, it is ignored and patterns are
|
|
923
|
-
determined internally (by using DCL.uegtlb).</li>
|
|
924
|
-
<li>If not, a linear tone levels are set if <code>"ltone"=true</code>
|
|
925
|
-
(this is the default), or shading is made if <code>"ltone"=false</code>.
|
|
926
|
-
Shading is determined by following the parameters in the UDPACK
|
|
927
|
-
in DCL. Therefore, coloring is made if DCL.udpget('ltone')==true
|
|
928
|
-
regardless the option <code>"ltone"=false</code> here.
|
|
929
|
-
When linear levels are set in this method, options
|
|
930
|
-
<code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, and <code>"interval"</code>
|
|
931
|
-
are used if specified, which are interpreted by
|
|
932
|
-
DCLExt::<a href="#label-67">ue_set_linear_levs</a>.
|
|
933
|
-
Their default values can be changed by
|
|
934
|
-
<a href="#label-34">set_linear_tone_options</a>.</li>
|
|
935
|
-
</ul></li>
|
|
936
|
-
</ul>
|
|
937
|
-
<p>ARGUMENTS</p>
|
|
938
|
-
<ul>
|
|
939
|
-
<li>gphys (GPhys) : a GPhys whose data is plotted.</li>
|
|
940
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a> (or <a href="#label-16">map</a>),
|
|
941
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
942
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
943
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
944
|
-
It is a Hash with option names (String) as keys and their values.
|
|
945
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
946
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
947
|
-
unambiguous.</p>
|
|
948
|
-
<pre>option name default value # description:
|
|
949
|
-
"title" nil # Title of the figure(if nil, internally
|
|
950
|
-
# determined)
|
|
951
|
-
"annotate" true # if false, do not put texts on the right
|
|
952
|
-
# margin even when newframe==true
|
|
953
|
-
"ltone" true # Same as udpack parameter ltone
|
|
954
|
-
"tonf" false # Use DCL.uetonf instead of DCL.uetone
|
|
955
|
-
"tonb" false # Use DCL.uetonb instead of DCL.uetone
|
|
956
|
-
"tonc" false # Use DCL.uetonc instead of DCL.uetone
|
|
957
|
-
"clr_min" nil # if an integer (in 10..99) is specified, used as
|
|
958
|
-
# the color number for the minimum data values.
|
|
959
|
-
# (the same can be done by setting the uepack
|
|
960
|
-
# parameter "icolor1")
|
|
961
|
-
"clr_max" nil # if an integer (in 10..99) is specified, used as
|
|
962
|
-
# the color number for the maximum data values.
|
|
963
|
-
# (the same can be done by setting the uepack
|
|
964
|
-
# parameter "icolor2")
|
|
965
|
-
"transpose" false # if true, exchange x and y axes
|
|
966
|
-
"exchange" false # same as the option transpose
|
|
967
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
968
|
-
# true, draws axes by temprarilly switching to
|
|
969
|
-
# itr=1 and calling GGraph::axes.
|
|
970
|
-
"keep" false # Use the tone levels and patterns used previously
|
|
971
|
-
"color_bar" false # Add a color bar: THIS IS ONLY FOR QUICK
|
|
972
|
-
# LOOK. Use the GGraph::color_bar method explicitly
|
|
973
|
-
# for full option control
|
|
974
|
-
"min" nil # minimum tone level
|
|
975
|
-
"max" nil # maximum tone level
|
|
976
|
-
"nlev" nil # number of levels
|
|
977
|
-
"interval" nil # contour interval
|
|
978
|
-
"help" false # show help message if true
|
|
979
|
-
"log" nil # approximately log-scaled levels (by using
|
|
980
|
-
# DCLExt::quasi_log_levels)
|
|
981
|
-
"log_cycle" 3 # (if log) number of levels in one-order (1 or 2
|
|
982
|
-
# or 3)
|
|
983
|
-
"levels" nil # tone levels (Array/NArray of Numeric). Works
|
|
984
|
-
# together with patterns
|
|
985
|
-
"patterns" nil # tone patters (Array/NArray of Numeric). Works
|
|
986
|
-
# together with levels
|
|
987
|
-
"xintv" 1 # interval of data sampling in x
|
|
988
|
-
"yintv" 1 # interval of data sampling in y
|
|
989
|
-
"xcoord" nil # Name of the coordinate variable for x-axis
|
|
990
|
-
"ycoord" nil # Name of the coordinate variable for y-axis
|
|
991
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
992
|
-
# subset the data before plotting (order applied:
|
|
993
|
-
# slice -> cut -> mean)
|
|
994
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
995
|
-
# method to subset the data before plotting (order
|
|
996
|
-
# applied: slice -> cut -> mean)
|
|
997
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
998
|
-
# take mean of the data before plotting (order
|
|
999
|
-
# applied: slice -> cut -> mean)</pre></li>
|
|
1000
|
-
</ul>
|
|
1001
|
-
<p>RETURN VALUE</p>
|
|
1002
|
-
<ul>
|
|
1003
|
-
<li>nil</li>
|
|
1004
|
-
</ul></dd>
|
|
1005
|
-
<dt><h4><a name="label-31" id="label-31"><code>color_bar (<var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "color_bar" -->
|
|
1006
|
-
<dd>
|
|
1007
|
-
<ul>
|
|
1008
|
-
<li>Descroption:
|
|
1009
|
-
Draws color bars. Calls <code>DCLext.color_bar</code>.</li>
|
|
1010
|
-
</ul></dd>
|
|
1011
|
-
<dt><h4><a name="label-32" id="label-32"><code>set_tone_levels(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_tone_levels" -->
|
|
1012
|
-
<dd>
|
|
1013
|
-
<p>Set tone levels for <a href="#label-30">tone</a> explicitly by values.</p>
|
|
1014
|
-
<p>ARGUMENTS</p>
|
|
1015
|
-
<ul>
|
|
1016
|
-
<li>options (Hash) : options to change the default behavior.
|
|
1017
|
-
Supported options are <code>"levels"</code> and <code>"patterns"</code>.
|
|
1018
|
-
Both of them must be specified explicitly (so they are
|
|
1019
|
-
not optional!).</li>
|
|
1020
|
-
</ul></dd>
|
|
1021
|
-
<dt><h4><a name="label-33" id="label-33"><code>clear_tone_levels</code></a></h4></dt><!-- RDLabel: "clear_tone_levels" -->
|
|
1022
|
-
<dd>
|
|
1023
|
-
Clear tone levels set by <a href="#label-32">set_tone_levels</a>.</dd>
|
|
1024
|
-
<dt><h4><a name="label-34" id="label-34"><code>set_linear_tone_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_linear_tone_options" -->
|
|
1025
|
-
<dd>
|
|
1026
|
-
<p>Change the default option values regarding linear tone level
|
|
1027
|
-
setting in <a href="#label-30">tone</a>.</p>
|
|
1028
|
-
<p>ARGUMENTS</p>
|
|
1029
|
-
<ul>
|
|
1030
|
-
<li>options (Hash) : The usage is the same as <code>options</code>
|
|
1031
|
-
for <a href="#label-30">tone</a> but supported options here are limited to
|
|
1032
|
-
<code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, and <code>"interval"</code>.</li>
|
|
1033
|
-
</ul>
|
|
1034
|
-
<p>RETURN VALUE</p>
|
|
1035
|
-
<ul>
|
|
1036
|
-
<li>a Hash containing the values replaced (the ones before calling this
|
|
1037
|
-
method)</li>
|
|
1038
|
-
</ul></dd>
|
|
1039
|
-
<dt><h4><a name="label-35" id="label-35"><code>next_linear_tone_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_linear_tone_options" -->
|
|
1040
|
-
<dd>
|
|
1041
|
-
Similar to <a href="#label-34">set_linear_tone_options</a> but the setting
|
|
1042
|
-
is effective only for the next call of <a href="#label-30">tone</a>.</dd>
|
|
1043
|
-
<dt><h4><a name="label-36" id="label-36"><code>set_unit_vect_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_unit_vect_options" -->
|
|
1044
|
-
<dt><h4><a name="label-37" id="label-37"><code>next_unit_vect_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_unit_vect_options" -->
|
|
1045
|
-
<dt><h4><a name="label-38" id="label-38"><code>vector(<var>fx</var>, <var>fy</var>, <var>newframe</var>=<var>true</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "vector" -->
|
|
1046
|
-
<dd>
|
|
1047
|
-
<p>2-D vector plot using DCL_Ext::<a href="#label-82">flow_vect</a>,
|
|
1048
|
-
which scales vectors in physical ("U") coordinates.</p>
|
|
1049
|
-
<p>ARGUMENTS</p>
|
|
1050
|
-
<ul>
|
|
1051
|
-
<li>fx, fy (GPhys) : represent vectors</li>
|
|
1052
|
-
<li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a> (or <a href="#label-16">map</a>),
|
|
1053
|
-
<a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
|
|
1054
|
-
the poly-line is drawn (overlaid to the exiting figure).</li>
|
|
1055
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
1056
|
-
It is a Hash with option names (String) as keys and their values.
|
|
1057
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
1058
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
1059
|
-
unambiguous.</p>
|
|
1060
|
-
<pre>option name default value # description:
|
|
1061
|
-
"title" nil # Title of the figure(if nil, internally
|
|
1062
|
-
# determined)
|
|
1063
|
-
"annotate" true # if false, do not put texts on the right
|
|
1064
|
-
# margin even when newframe==true
|
|
1065
|
-
"transpose" false # if true, exchange x and y axes
|
|
1066
|
-
"exchange" false # same as the option transpose
|
|
1067
|
-
"map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
|
|
1068
|
-
# true, draws axes by temprarilly switching to
|
|
1069
|
-
# itr=1 and calling GGraph::axes.
|
|
1070
|
-
"flow_vect" true # If true, use DCLExt::flow_vect to draw
|
|
1071
|
-
# vectors; otherwise, DCL::ugvect is used.
|
|
1072
|
-
"flow_itr5" false # If true, use DCLExt::flow_itr5 to draw
|
|
1073
|
-
# vectors; otherwise, DCLExt::flow_vect or
|
|
1074
|
-
# DCL::ugvect is used.
|
|
1075
|
-
"keep" false # Use the same vector scaling as in the previous
|
|
1076
|
-
# call. -- Currently, works only when "flow_vect"
|
|
1077
|
-
# is true
|
|
1078
|
-
"xintv" 1 # (Effective only if flow_vect) interval of data
|
|
1079
|
-
# sampling in x
|
|
1080
|
-
"yintv" 1 # (Effective only if flow_vect) interval of data
|
|
1081
|
-
# sampling in y
|
|
1082
|
-
"factor" 1.0 # (Effective only if flow_vect) scaling factor to
|
|
1083
|
-
# strech/reduce the arrow lengths
|
|
1084
|
-
"unit_vect" false # Show the unit vector
|
|
1085
|
-
"max_unit_vect" false # (Effective only if flow_vect &&
|
|
1086
|
-
# unit_vect) If true, use the maximum arrows to
|
|
1087
|
-
# scale the unit vector; otherwise, normalize in V
|
|
1088
|
-
# coordinate.
|
|
1089
|
-
"help" false # show help message if true
|
|
1090
|
-
"xcoord" nil # Name of the coordinate variable for x-axis
|
|
1091
|
-
"ycoord" nil # Name of the coordinate variable for y-axis
|
|
1092
|
-
"slice" nil # An Array to be pathed to the GPhys#[] method to
|
|
1093
|
-
# subset the data before plotting (order applied:
|
|
1094
|
-
# slice -> cut -> mean)
|
|
1095
|
-
"cut" nil # An Array or Hash to be pathed to the GPhys#cut
|
|
1096
|
-
# method to subset the data before plotting (order
|
|
1097
|
-
# applied: slice -> cut -> mean)
|
|
1098
|
-
"mean" nil # An Array to be pathed to the GPhys#mean method to
|
|
1099
|
-
# take mean of the data before plotting (order
|
|
1100
|
-
# applied: slice -> cut -> mean)</pre></li>
|
|
1101
|
-
</ul>
|
|
1102
|
-
<p>RETURN VALUE</p>
|
|
1103
|
-
<ul>
|
|
1104
|
-
<li>nil</li>
|
|
1105
|
-
</ul></dd>
|
|
1106
|
-
</dl>
|
|
1107
|
-
<h1><a name="label-39" id="label-39">module NumRu::DCLExt</a></h1><!-- RDLabel: "module NumRu::DCLExt" -->
|
|
1108
|
-
<p>Collection of various compound DCL functions for convenience.
|
|
1109
|
-
This module is to be separated but temporarily included in ggraph.rb
|
|
1110
|
-
while it is premature.</p>
|
|
1111
|
-
<h2><a name="label-40" id="label-40">Index</a></h2><!-- RDLabel: "Index" -->
|
|
1112
|
-
<p>MATH1</p>
|
|
1113
|
-
<ul>
|
|
1114
|
-
<li><a href="#label-42">glpack</a></li>
|
|
1115
|
-
</ul>
|
|
1116
|
-
<p>GRPH1</p>
|
|
1117
|
-
<ul>
|
|
1118
|
-
<li><a href="#label-44">sgpack</a></li>
|
|
1119
|
-
<li><a href="#label-46">slpack</a></li>
|
|
1120
|
-
<li><a href="#label-48">swpack</a></li>
|
|
1121
|
-
</ul>
|
|
1122
|
-
<p>GRPH2</p>
|
|
1123
|
-
<ul>
|
|
1124
|
-
<li><a href="#label-50">uzpack</a></li>
|
|
1125
|
-
<li><a href="#label-52">ulpack</a></li>
|
|
1126
|
-
<li><a href="#label-54">ucpack</a></li>
|
|
1127
|
-
<li><a href="#label-56">uupack</a></li>
|
|
1128
|
-
<li><a href="#label-58">uspack</a></li>
|
|
1129
|
-
<li><a href="#label-60">udpack</a></li>
|
|
1130
|
-
<li><a href="#label-65">uepack</a></li>
|
|
1131
|
-
<li><a href="#label-70">ugpack</a></li>
|
|
1132
|
-
<li><a href="#label-72">umpack</a></li>
|
|
1133
|
-
</ul>
|
|
1134
|
-
<h2><a name="label-41" id="label-41">Module Functions</a></h2><!-- RDLabel: "Module Functions" -->
|
|
1135
|
-
<h3><a name="label-42" id="label-42">glpack</a></h3><!-- RDLabel: "glpack" -->
|
|
1136
|
-
<dl>
|
|
1137
|
-
<dt><h4><a name="label-43" id="label-43"><code>gl_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "gl_set_params" -->
|
|
1138
|
-
<dd>
|
|
1139
|
-
<p>Calls <code>DCL.glpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1140
|
-
<p>ARGUMENTS</p>
|
|
1141
|
-
<ul>
|
|
1142
|
-
<li>hash (Hash) : combinations of parameter names and values for udpset</li>
|
|
1143
|
-
</ul>
|
|
1144
|
-
<p>RETURN VALUE</p>
|
|
1145
|
-
<ul>
|
|
1146
|
-
<li>a Hash containing the parameter names and their old values that were
|
|
1147
|
-
replaced.</li>
|
|
1148
|
-
</ul>
|
|
1149
|
-
<p>EXAMPLES</p>
|
|
1150
|
-
<ul>
|
|
1151
|
-
<li><p>You can modify parameters temporarily as follows.</p>
|
|
1152
|
-
<pre>before = DCLExt.gl_set_params({'lmiss'=>true,'rmiss'=>9999.0})
|
|
1153
|
-
....
|
|
1154
|
-
DCLExt.gl_set_params(before) # reset the change</pre></li>
|
|
1155
|
-
</ul></dd>
|
|
1156
|
-
</dl>
|
|
1157
|
-
<h3><a name="label-44" id="label-44">sgpack</a></h3><!-- RDLabel: "sgpack" -->
|
|
1158
|
-
<dl>
|
|
1159
|
-
<dt><h4><a name="label-45" id="label-45"><code>sg_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "sg_set_params" -->
|
|
1160
|
-
<dd>
|
|
1161
|
-
<p>Calls <code>DCL.sgpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1162
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1163
|
-
</dl>
|
|
1164
|
-
<h3><a name="label-46" id="label-46">slpack</a></h3><!-- RDLabel: "slpack" -->
|
|
1165
|
-
<dl>
|
|
1166
|
-
<dt><h4><a name="label-47" id="label-47"><code>sl_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "sl_set_params" -->
|
|
1167
|
-
<dd>
|
|
1168
|
-
<p>Calls <code>DCL.slpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1169
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1170
|
-
</dl>
|
|
1171
|
-
<h3><a name="label-48" id="label-48">swpack</a></h3><!-- RDLabel: "swpack" -->
|
|
1172
|
-
<dl>
|
|
1173
|
-
<dt><h4><a name="label-49" id="label-49"><code>sw_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "sw_set_params" -->
|
|
1174
|
-
<dd>
|
|
1175
|
-
<p>Calls <code>DCL.swpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1176
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1177
|
-
</dl>
|
|
1178
|
-
<h3><a name="label-50" id="label-50">uzpack</a></h3><!-- RDLabel: "uzpack" -->
|
|
1179
|
-
<dl>
|
|
1180
|
-
<dt><h4><a name="label-51" id="label-51"><code>uz_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "uz_set_params" -->
|
|
1181
|
-
<dd>
|
|
1182
|
-
<p>Calls <code>DCL.uzpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1183
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1184
|
-
</dl>
|
|
1185
|
-
<h3><a name="label-52" id="label-52">ulpack</a></h3><!-- RDLabel: "ulpack" -->
|
|
1186
|
-
<dl>
|
|
1187
|
-
<dt><h4><a name="label-53" id="label-53"><code>ul_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "ul_set_params" -->
|
|
1188
|
-
<dd>
|
|
1189
|
-
<p>Calls <code>DCL.ulpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1190
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1191
|
-
</dl>
|
|
1192
|
-
<h3><a name="label-54" id="label-54">ucpack</a></h3><!-- RDLabel: "ucpack" -->
|
|
1193
|
-
<dl>
|
|
1194
|
-
<dt><h4><a name="label-55" id="label-55"><code>uc_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "uc_set_params" -->
|
|
1195
|
-
<dd>
|
|
1196
|
-
<p>Calls <code>DCL.ucpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1197
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1198
|
-
</dl>
|
|
1199
|
-
<h3><a name="label-56" id="label-56">uupack</a></h3><!-- RDLabel: "uupack" -->
|
|
1200
|
-
<dl>
|
|
1201
|
-
<dt><h4><a name="label-57" id="label-57"><code>uu_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "uu_set_params" -->
|
|
1202
|
-
<dd>
|
|
1203
|
-
<p>Calls <code>DCL.uupset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1204
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1205
|
-
</dl>
|
|
1206
|
-
<h3><a name="label-58" id="label-58">uspack</a></h3><!-- RDLabel: "uspack" -->
|
|
1207
|
-
<dl>
|
|
1208
|
-
<dt><h4><a name="label-59" id="label-59"><code>us_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "us_set_params" -->
|
|
1209
|
-
<dd>
|
|
1210
|
-
<p>Calls <code>DCL.uspset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1211
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1212
|
-
</dl>
|
|
1213
|
-
<h3><a name="label-60" id="label-60">udpack</a></h3><!-- RDLabel: "udpack" -->
|
|
1214
|
-
<dl>
|
|
1215
|
-
<dt><h4><a name="label-61" id="label-61"><code>ud_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "ud_set_params" -->
|
|
1216
|
-
<dd>
|
|
1217
|
-
<p>Calls <code>DCL.udpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1218
|
-
<p>ARGUMENTS</p>
|
|
1219
|
-
<ul>
|
|
1220
|
-
<li>hash (Hash) : combinations of parameter names and values for udpset</li>
|
|
1221
|
-
</ul>
|
|
1222
|
-
<p>RETURN VALUE</p>
|
|
1223
|
-
<ul>
|
|
1224
|
-
<li>a Hash containing the parameter names and their old values that were
|
|
1225
|
-
replaced.</li>
|
|
1226
|
-
</ul>
|
|
1227
|
-
<p>EXAMPLES</p>
|
|
1228
|
-
<ul>
|
|
1229
|
-
<li><p>You can modify parameters temporarily as follows.</p>
|
|
1230
|
-
<pre>before = DCLExt.ud_set_params('indxmj'=>4,'lmsg'=>false)
|
|
1231
|
-
DCL.udcntz(data)
|
|
1232
|
-
DCLExt.ud_set_params(before) # reset the change</pre></li>
|
|
1233
|
-
</ul></dd>
|
|
1234
|
-
<dt><h4><a name="label-62" id="label-62"><code>ud_set_linear_levs(<var>v</var>, <var>options</var>)</code></a></h4></dt><!-- RDLabel: "ud_set_linear_levs" -->
|
|
1235
|
-
<dd>
|
|
1236
|
-
<p>Set contour levels with a constant interval</p>
|
|
1237
|
-
<p>ARGUMENTS</p>
|
|
1238
|
-
<ul>
|
|
1239
|
-
<li>v : Data values to be fed to udcnt[rz]</li>
|
|
1240
|
-
<li><p>options (Hash) : option specification by keys and values. Available
|
|
1241
|
-
options are</p>
|
|
1242
|
-
<pre>name default value description
|
|
1243
|
-
'min' nil minimum contour value (Numeric)
|
|
1244
|
-
'max' nil maximum contour value (Numeric)
|
|
1245
|
-
'nlev' nil number of levels (Integer)
|
|
1246
|
-
'interval' nil contour interval (Numeric)
|
|
1247
|
-
'nozero' nil delete zero contour (true/false)
|
|
1248
|
-
'coloring' false set color contours with ud_coloring (true/false)
|
|
1249
|
-
'clr_min' 13 (if coloring) minimum color id (Integer)
|
|
1250
|
-
'clr_max' 99 (if coloring) maximum color id (Integer)</pre>
|
|
1251
|
-
<p>Here, <code>interval</code> has a higher precedence over <code>nlev</code>.
|
|
1252
|
-
Since all the default values are nil, only those explicitly specified
|
|
1253
|
-
are interpreted. If no option is provided, the levels generated will
|
|
1254
|
-
be the default ones set by udcnt[rz] without any level specification.</p></li>
|
|
1255
|
-
</ul></dd>
|
|
1256
|
-
<dt><h4><a name="label-63" id="label-63"><code>ud_set_contour(<var>levels</var>,<var>index</var>=<var>nil</var>,<var>line_type</var>=<var>nil</var>,<var>label</var>=<var>nil</var>,<var>label_height</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "ud_set_contour" -->
|
|
1257
|
-
<dd>
|
|
1258
|
-
<p>Set contours of at specified levels.</p>
|
|
1259
|
-
<p>Normally you do not have to specify <code>label</code> and <code>label_height</code>.</p>
|
|
1260
|
-
<p>It calls DCL.udsclv for each level. So the arguments are basically
|
|
1261
|
-
the same as DCL.udsclv, but only levels are mandatory here.</p>
|
|
1262
|
-
<p>ARGUMENTS</p>
|
|
1263
|
-
<ul>
|
|
1264
|
-
<li>levels (Array, NArray, or Numeric) : contour levels to be set.
|
|
1265
|
-
If Numeric, a single level is set.</li>
|
|
1266
|
-
<li>index (Array of integers, Integer, or nil) :
|
|
1267
|
-
index(es) of the contours. If it is an Array and its length is
|
|
1268
|
-
shorter than that of <code>levels</code>, the same Array is repeated (so
|
|
1269
|
-
for instance [1,1,3] is interpreted as [1,1,3,1,1,3,1,1,3,...]).
|
|
1270
|
-
If it is a single Integer, all the contour will have the same index.</li>
|
|
1271
|
-
</ul>
|
|
1272
|
-
<pre>If nil, the value of 'indxmn' is used.</pre>
|
|
1273
|
-
<ul>
|
|
1274
|
-
<li>line_type (Array of integers, Integer, or nil) :
|
|
1275
|
-
line type(s) of the contours. If it is an Array and its length is
|
|
1276
|
-
shorter than that of <code>levels</code>, the same Array is repeated.
|
|
1277
|
-
the length must agree with that of <code>levels</code>.
|
|
1278
|
-
If it is a single Integer, all the contour will have the same type.
|
|
1279
|
-
If nil, set to be 1.</li>
|
|
1280
|
-
<li>label (Array of String, String, true, false, nil) :
|
|
1281
|
-
Label(s) of the contours. If it is an Array and its length is
|
|
1282
|
-
shorter than that of <code>levels</code>, the same Array is repeated.
|
|
1283
|
-
the length must agree with that of <code>levels</code>.
|
|
1284
|
-
If it is a single String, all the contour will have the same label.
|
|
1285
|
-
If true, all the contours will have the labels representing the levels.
|
|
1286
|
-
If false, no label will be drawn (set to "").
|
|
1287
|
-
If nil, same as true for the contours whose index is equal to "INDXMJ",
|
|
1288
|
-
and same as false otherwise.</li>
|
|
1289
|
-
<li>label_height (Array of Numeric, Numeric, or nil) :
|
|
1290
|
-
Heigh of Labels. Normally you do not have to use this.
|
|
1291
|
-
If it is an Array and its length is
|
|
1292
|
-
shorter than that of <code>levels</code>, the same Array is repeated.
|
|
1293
|
-
If nil, the default value ("RSIZEL") is used for non-empty labels.
|
|
1294
|
-
If a single Numeric, the same value is used for all the contours.
|
|
1295
|
-
Note that it is recommended to not to use this parameter but
|
|
1296
|
-
use DCL.udpset('RZISEL'. label_height), since a positive value
|
|
1297
|
-
here always means to draw labels even when the label is empty.</li>
|
|
1298
|
-
</ul>
|
|
1299
|
-
<p>RETURN VALUE</p>
|
|
1300
|
-
<ul>
|
|
1301
|
-
<li>nil</li>
|
|
1302
|
-
</ul></dd>
|
|
1303
|
-
<dt><h4><a name="label-64" id="label-64"><code>ud_add_contour(<var>levels</var>,<var>index</var>=<var>nil</var>,<var>line_type</var>=<var>nil</var>,<var>label</var>=<var>nil</var>,<var>label_height</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "ud_add_contour" -->
|
|
1304
|
-
<dd>
|
|
1305
|
-
Same as <a href="#label-63">ud_set_contour</a>, but does not clear the contour levels that have
|
|
1306
|
-
been set.</dd>
|
|
1307
|
-
</dl>
|
|
1308
|
-
<h3><a name="label-65" id="label-65">uepack</a></h3><!-- RDLabel: "uepack" -->
|
|
1309
|
-
<dl>
|
|
1310
|
-
<dt><h4><a name="label-66" id="label-66"><code>ue_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "ue_set_params" -->
|
|
1311
|
-
<dd>
|
|
1312
|
-
<p>Calls <code>DCL.uepset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1313
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1314
|
-
<dt><h4><a name="label-67" id="label-67"><code>ue_set_linear_levs(<var>v</var>, <var>options</var>)</code></a></h4></dt><!-- RDLabel: "ue_set_linear_levs" -->
|
|
1315
|
-
<dd>
|
|
1316
|
-
<p>Set tone levels with a constant interval</p>
|
|
1317
|
-
<p>ARGUMENTS</p>
|
|
1318
|
-
<ul>
|
|
1319
|
-
<li>v : Data values to be fed to udcnt[rz]</li>
|
|
1320
|
-
<li><p>options (Hash) : option specification by keys and values. Available
|
|
1321
|
-
options are</p>
|
|
1322
|
-
<pre>name default value description
|
|
1323
|
-
'min' nil minimum tone level (Numeric)
|
|
1324
|
-
'max' nil maximum tone level (Numeric)
|
|
1325
|
-
'nlev' nil number of levels (Integer)
|
|
1326
|
-
'interval' nil tone-level interval (Numeric)</pre>
|
|
1327
|
-
<p>Here, <code>interval</code> has a higher precedence over <code>nlev</code>.
|
|
1328
|
-
Since all the default values are nil, only those explicitly specified
|
|
1329
|
-
are interpreted. If no option is provided, the levels generated will
|
|
1330
|
-
be the default ones set by udcnt[rz] without any level specification.</p></li>
|
|
1331
|
-
</ul></dd>
|
|
1332
|
-
<dt><h4><a name="label-68" id="label-68"><code>ue_set_tone(<var>levels</var>, <var>patterns</var>)</code></a></h4></dt><!-- RDLabel: "ue_set_tone" -->
|
|
1333
|
-
<dd>
|
|
1334
|
-
<p>Set tone levels and patterns.</p>
|
|
1335
|
-
<p>patterns are set between levels as follows:</p>
|
|
1336
|
-
<pre>when (levels.length == patterns.length+1)
|
|
1337
|
-
|
|
1338
|
-
levels[0] | levels[1] | levels[2] ... | levels[-2] | levels[-1]
|
|
1339
|
-
patterns[0] patterns[1] ... patterns[-2] patterns[-1]
|
|
1340
|
-
|
|
1341
|
-
when (levels.length == patterns.length)
|
|
1342
|
-
|
|
1343
|
-
levels[0] | levels[1] | levels[2] ... | levels[-1] | +infty
|
|
1344
|
-
patterns[0] patterns[1] ... patterns[-2] patterns[-1]
|
|
1345
|
-
|
|
1346
|
-
when (levels.length == patterns.length-1)
|
|
1347
|
-
|
|
1348
|
-
-infty | levels[0] | levels[1] ... | levels[-1] | +infty
|
|
1349
|
-
patterns[0] patterns[1] ... patterns[-2] patterns[-1]
|
|
1350
|
-
|
|
1351
|
-
else
|
|
1352
|
-
error (exception raised)</pre>
|
|
1353
|
-
<p>ARGUMENTS</p>
|
|
1354
|
-
<ul>
|
|
1355
|
-
<li>levels (Array or NArray of Numeric) : tone levels. Its length must be
|
|
1356
|
-
either 1 larger than, equal to, or 1 smaller than the length of patterns</li>
|
|
1357
|
-
<li>patterns (Array or NArray of Numeric) : tone patterns</li>
|
|
1358
|
-
</ul>
|
|
1359
|
-
<p>RETURN VALUE</p>
|
|
1360
|
-
<ul>
|
|
1361
|
-
<li>nil</li>
|
|
1362
|
-
</ul></dd>
|
|
1363
|
-
<dt><h4><a name="label-69" id="label-69"><code>ue_add_tone(<var>levels</var>, <var>patterns</var>)</code></a></h4></dt><!-- RDLabel: "ue_add_tone" -->
|
|
1364
|
-
<dd>
|
|
1365
|
-
Same as <a href="#label-68">ue_set_tone</a>, but does not clear the tone levels that have
|
|
1366
|
-
been set.</dd>
|
|
1367
|
-
</dl>
|
|
1368
|
-
<h3><a name="label-70" id="label-70">ugpack</a></h3><!-- RDLabel: "ugpack" -->
|
|
1369
|
-
<dl>
|
|
1370
|
-
<dt><h4><a name="label-71" id="label-71"><code>ug_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "ug_set_params" -->
|
|
1371
|
-
<dd>
|
|
1372
|
-
Calls <code>DCL.ugpset</code> multiple times (for each key and val of <code>hash</code>).
|
|
1373
|
-
See <a href="#label-43">gl_set_params</a> for usage.</dd>
|
|
1374
|
-
</dl>
|
|
1375
|
-
<h3><a name="label-72" id="label-72">umpack</a></h3><!-- RDLabel: "umpack" -->
|
|
1376
|
-
<dl>
|
|
1377
|
-
<dt><h4><a name="label-73" id="label-73"><code>um_set_params(<var>hash</var>)</code></a></h4></dt><!-- RDLabel: "um_set_params" -->
|
|
1378
|
-
<dd>
|
|
1379
|
-
<p>Calls <code>DCL.umpset</code> multiple times (for each key and val of <code>hash</code>).</p>
|
|
1380
|
-
<p>See <a href="#label-43">gl_set_params</a> for usage.</p></dd>
|
|
1381
|
-
</dl>
|
|
1382
|
-
<h2><a name="label-74" id="label-74">Original methods:</a></h2><!-- RDLabel: "Original methods:" -->
|
|
1383
|
-
<h3><a name="label-75" id="label-75">Longitude/Latitude Axes</a></h3><!-- RDLabel: "Longitude/Latitude Axes" -->
|
|
1384
|
-
<dl>
|
|
1385
|
-
<dt><h4><a name="label-76" id="label-76"><code>lon_ax( <var>options</var>=<var>nil</var> )</code></a></h4></dt><!-- RDLabel: "lon_ax" -->
|
|
1386
|
-
<dd>
|
|
1387
|
-
<p>Draw longitude axis. (label format: degrees + 'E' or 'W')</p>
|
|
1388
|
-
<p>ARGUMENTS</p>
|
|
1389
|
-
<ul>
|
|
1390
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
1391
|
-
It is a Hash with option names (String) as keys and their values.
|
|
1392
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
1393
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
1394
|
-
unambiguous.</p>
|
|
1395
|
-
<pre>option name default value # description:
|
|
1396
|
-
"yax" false # true => draw y-axis, false => draw x-axis
|
|
1397
|
-
"cside" nil # "b", "t", "l", "r",
|
|
1398
|
-
# nil (=>left/bottom), or false (=>right/top)
|
|
1399
|
-
"dtick1" nil # Interval of small tickmark
|
|
1400
|
-
# (if nil, internally determined)
|
|
1401
|
-
"dtick2" nil # Interval of large tickmark with labels
|
|
1402
|
-
# (if nil, internally determined)</pre></li>
|
|
1403
|
-
</ul></dd>
|
|
1404
|
-
<dt><h4><a name="label-77" id="label-77"><code>lat_ax( <var>options</var>=<var>nil</var> )</code></a></h4></dt><!-- RDLabel: "lat_ax" -->
|
|
1405
|
-
<dd>
|
|
1406
|
-
<p>Draw latitude axis. (label format: degrees + 'N' or 'S')</p>
|
|
1407
|
-
<p>ARGUMENTS</p>
|
|
1408
|
-
<ul>
|
|
1409
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
1410
|
-
It is a Hash with option names (String) as keys and their values.
|
|
1411
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
1412
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
1413
|
-
unambiguous.</p>
|
|
1414
|
-
<pre>option name default value # description:
|
|
1415
|
-
"xax" false # true => draw x-axis, false => draw y-axis
|
|
1416
|
-
"cside" nil # "b", "t", "l", "r",
|
|
1417
|
-
# nil (=>left/bottom), or false (=>right/top)
|
|
1418
|
-
"dtick1" nil # Interval of small tickmark
|
|
1419
|
-
# (if nil, internally determined)
|
|
1420
|
-
"dtick2" nil # Interval of large tickmark with labels
|
|
1421
|
-
# (if nil, internally determined)</pre></li>
|
|
1422
|
-
</ul></dd>
|
|
1423
|
-
</dl>
|
|
1424
|
-
<h3><a name="label-78" id="label-78">Vectors</a></h3><!-- RDLabel: "Vectors" -->
|
|
1425
|
-
<dl>
|
|
1426
|
-
<dt><h4><a name="label-79" id="label-79"><code>unit_vect( <var>vxfxratio</var>, <var>vyfyratio</var>, <var>fxunit</var>=<var>nil</var>, <var>fyunit</var>=<var>nil</var>, <var>options</var>=<var>nil</var> )</code></a></h4></dt><!-- RDLabel: "unit_vect" -->
|
|
1427
|
-
<dd>
|
|
1428
|
-
<p>Show the "unit vector", which indicate the vector scaling.</p>
|
|
1429
|
-
<p>ARGUMENTS</p>
|
|
1430
|
-
<ul>
|
|
1431
|
-
<li>vxfxratio (Float) : (V cood length)/(actual length) in x</li>
|
|
1432
|
-
<li>vyfyratio (Float) : (V cood length)/(actual length) in y</li>
|
|
1433
|
-
<li>fxunit (Float) : If specified, x unit vect len</li>
|
|
1434
|
-
<li>fyunit (Float) : If specified, y unit vect len</li>
|
|
1435
|
-
<li><p>options (Hash) : options to change the default behavior if specified.
|
|
1436
|
-
It is a Hash with option names (String) as keys and their values.
|
|
1437
|
-
Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
|
|
1438
|
-
so you can shorten the keys (by omitting tails) as long as it is
|
|
1439
|
-
unambiguous.</p>
|
|
1440
|
-
<pre>option name default value # description:
|
|
1441
|
-
"vxunit" 0.05 # x unit vect len in V coord. Used only when
|
|
1442
|
-
# fxunit is omitted (default)
|
|
1443
|
-
"vyunit" 0.05 # y unit vect len in V coord. Used only when
|
|
1444
|
-
# fyunit is omitted (default)
|
|
1445
|
-
"vxuloc" nil # Starting x position of unit vect
|
|
1446
|
-
"vyuloc" nil # Starting y position of unit vect
|
|
1447
|
-
"vxuoff" 0.05 # Specify vxuloc by offset from right-bottom
|
|
1448
|
-
# corner
|
|
1449
|
-
"vyuoff" 0.0 # Specify vyuloc by offset from right-bottom
|
|
1450
|
-
# corner
|
|
1451
|
-
"inplace" true # Whether to print labels right by the unit
|
|
1452
|
-
# vector (true) or below the x axis (false)
|
|
1453
|
-
"rsizet" nil # Label size(default taken from uz-parameter
|
|
1454
|
-
# 'rsizel1')
|
|
1455
|
-
"index" 3 # Line index of the unit vector
|
|
1456
|
-
"help" false # show help message if true</pre></li>
|
|
1457
|
-
</ul></dd>
|
|
1458
|
-
<dt><h4><a name="label-80" id="label-80"><code>set_unit_vect_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_unit_vect_options" -->
|
|
1459
|
-
<dd>
|
|
1460
|
-
Change the default option values for <a href="#label-79">unit_vect</a>.</dd>
|
|
1461
|
-
<dt><h4><a name="label-81" id="label-81"><code>next_unit_vect_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_unit_vect_options" -->
|
|
1462
|
-
<dd>
|
|
1463
|
-
Set the option values effective only in the next call of <a href="#label-79">unit_vect</a></dd>
|
|
1464
|
-
<dt><h4><a name="label-82" id="label-82"><code>flow_vect( <var>fx</var>, <var>fy</var>, <var>factor</var>=<var>1</var>.<var>0</var>, <var>xintv</var>=<var>1</var>, <var>yintv</var>=<var>1</var>)</code></a></h4></dt><!-- RDLabel: "flow_vect" -->
|
|
1465
|
-
<dd>
|
|
1466
|
-
<p>2D Vector plot. Unlike <code>DCL::ugvect</code>, scaling are made in term of the physical (or "U") coordinate.</p>
|
|
1467
|
-
<p>This method is meant to substitute <code>DCL::ugvect</code>. The scaling
|
|
1468
|
-
is made in terms of the U coordinate. This method is suitable to
|
|
1469
|
-
show vectors such as velocity, since the arrow direction represets
|
|
1470
|
-
the direction in the U coordinate. Also, one can re-scale the
|
|
1471
|
-
vector length easily by using the argument <code>factor</code>.</p>
|
|
1472
|
-
<p>Currently, this method is not compatible with map projection,
|
|
1473
|
-
since it calls <code>DCL::ugvect</code> internally.</p>
|
|
1474
|
-
<p>ARGUMENTS</p>
|
|
1475
|
-
<ul>
|
|
1476
|
-
<li>fx, fy (2D NArray or Array) : the vector field.</li>
|
|
1477
|
-
<li>factor (Integer) : factor to change the arrow length.
|
|
1478
|
-
By default, arrows are scaled so that the longest one
|
|
1479
|
-
match the grid interval.</li>
|
|
1480
|
-
<li>xintv, yintv (Interger) : interval to thin out <code>fx</code> and <code>fy</code>,
|
|
1481
|
-
respectively. Useful if the grid points are too many.</li>
|
|
1482
|
-
</ul></dd>
|
|
1483
|
-
<dt><h4><a name="label-83" id="label-83"><code>flow_itr5( <var>fx</var>, <var>fy</var>, <var>factor</var>=<var>1</var>.<var>0</var>, <var>unit_vect</var>=<var>false</var> )</code></a></h4></dt><!-- RDLabel: "flow_itr5" -->
|
|
1484
|
-
<dd>
|
|
1485
|
-
<p>2D Vector plot on the polar coodinate.</p>
|
|
1486
|
-
<p>This method just perform rotatation of the vector in U-coordinate
|
|
1487
|
-
to N-coordinate and passed to DCL.ugvect.</p>
|
|
1488
|
-
<p>ARGUMENTS</p>
|
|
1489
|
-
<ul>
|
|
1490
|
-
<li>fx, fy (2D GPhys) : the vector field.</li>
|
|
1491
|
-
<li>factor (Integer) : factor for scaling in ugvect. When it equals 1,
|
|
1492
|
-
vector field will be scaled in DCL.ugvect automatically.</li>
|
|
1493
|
-
<li>unit_vect() : Show the unit vector</li>
|
|
1494
|
-
</ul></dd>
|
|
1495
|
-
</dl>
|
|
1496
|
-
<h3><a name="label-84" id="label-84">Color bars</a></h3><!-- RDLabel: "Color bars" -->
|
|
1497
|
-
<dl>
|
|
1498
|
-
<dt><h4><a name="label-85" id="label-85"><code>set_color_bar_options(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_color_bar_options" -->
|
|
1499
|
-
<dd>
|
|
1500
|
-
To set options of <a href="#label-31">color_bar</a> effective in the rest.</dd>
|
|
1501
|
-
<dt><h4><a name="label-86" id="label-86"><code>color_bar(<var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "color_bar" -->
|
|
1502
|
-
<dd>
|
|
1503
|
-
<ul>
|
|
1504
|
-
<li>Descroption:
|
|
1505
|
-
Draws color bars</li>
|
|
1506
|
-
<li><p>Example
|
|
1507
|
-
Here is the simplest case, where no argument is given to color_bar.</p>
|
|
1508
|
-
<pre>DCL.uetone(hoge)
|
|
1509
|
-
DCL.usdaxs
|
|
1510
|
-
...
|
|
1511
|
-
DCL.color_bar</pre>
|
|
1512
|
-
<p>This draws a color bar by using the levels and tone patterns(colors)
|
|
1513
|
-
set previously. There are many parameters you can set manually,
|
|
1514
|
-
as introduced below:</p></li>
|
|
1515
|
-
<li><p>Description of options</p>
|
|
1516
|
-
<pre>option name default value # description:
|
|
1517
|
-
"levels" nil # tone levels (if omitted, latest ones are used)
|
|
1518
|
-
"patterns" nil # tone patterns (~colors) (if omitted, latest
|
|
1519
|
-
# ones are used)
|
|
1520
|
-
"voff" nil # how far is the bar from the viewport in the V
|
|
1521
|
-
# coordinate
|
|
1522
|
-
"vcent" nil # center position of the bar in the V coordinate
|
|
1523
|
-
# (VX or VY)
|
|
1524
|
-
"vlength" 0.3 # bar length in the V coordinate
|
|
1525
|
-
"vwidth" 0.02 # bar width in the V coordinate
|
|
1526
|
-
"inffact" 2.25 # factor to change the length of triangle on the
|
|
1527
|
-
# side for infinity (relative to 'vwidth')
|
|
1528
|
-
"landscape" false # if true, horizonlly long (along x axes)
|
|
1529
|
-
"portrait" true # if true, vertically long (along y axes)
|
|
1530
|
-
"top" false # place the bar at the top (effective if
|
|
1531
|
-
# landscape)
|
|
1532
|
-
"left" false # place the bar in the left (effective if
|
|
1533
|
-
# portrait)
|
|
1534
|
-
"units" nil # units of the axis of the color bar
|
|
1535
|
-
"units_voff" 0.0 # offset value for units from the default position
|
|
1536
|
-
# in the V coordinate (only for 'units' != nil)
|
|
1537
|
-
"title" nil # title of the color bar
|
|
1538
|
-
"title_voff" 0.0 # offset value for title from the default position
|
|
1539
|
-
# in the V coordinate (only for 'title' != nil)
|
|
1540
|
-
"tickintv" 1 # 0,1,2,3,.. to specify how frequently the
|
|
1541
|
-
# dividing tick lines are drawn (0: no tick lines,
|
|
1542
|
-
# 1: every time, 2: ever other:,...)
|
|
1543
|
-
"labelintv" nil # 0,1,2,3,.. to specify how frequently labels are
|
|
1544
|
-
# drawn (0: no labels, 1: every time, 2: ever
|
|
1545
|
-
# other:,... default: internally determined)
|
|
1546
|
-
"labels_ud" nil # user-defined labels for replacing the default
|
|
1547
|
-
# labels (Array of String)
|
|
1548
|
-
"charfact" 0.9 # factor to change the label/units/title character
|
|
1549
|
-
# size (relative to 'rsizel1')
|
|
1550
|
-
"log" false # set the color bar scale to logarithmic
|
|
1551
|
-
"constwidth" false # if true, each color is drawn with the same width
|
|
1552
|
-
"index" nil # line index of tick lines and bar frame
|
|
1553
|
-
"charindex" nil # line index of labels, units, and title
|
|
1554
|
-
"chval_fmt" nil # string to specify the DCL.chval format for
|
|
1555
|
-
# labeling
|
|
1556
|
-
"help" false # show help message if true</pre></li>
|
|
1557
|
-
</ul></dd>
|
|
1558
|
-
</dl>
|
|
1559
|
-
<h3><a name="label-87" id="label-87">Others</a></h3><!-- RDLabel: "Others" -->
|
|
1560
|
-
<dl>
|
|
1561
|
-
<dt><h4><a name="label-88" id="label-88"><code>legend(<var>str</var>, <var>type</var>, <var>index</var>, <var>line</var>=<var>false</var>, <var>size</var>=<var>nil</var>, <var>vx</var>=<var>nil</var>, <var>dx</var>=<var>nil</var>, <var>vy</var>=<var>nil</var>, <var>first</var>=<var>true</var>, <var>mark_size</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "legend" -->
|
|
1562
|
-
</dl>
|
|
1563
|
-
<p>Annotates line/mark type and index (and size if mark).
|
|
1564
|
-
By defualt it is shown in the right margin of the viewport.</p>
|
|
1565
|
-
<ul>
|
|
1566
|
-
<li>str is a String to show</li>
|
|
1567
|
-
<li>line: true->line ; false->mark</li>
|
|
1568
|
-
<li>vx: vx of the left-hand point of legend line (or mark position).
|
|
1569
|
-
<ul>
|
|
1570
|
-
<li>nil : internally determined</li>
|
|
1571
|
-
<li>Float && > 0 : set explicitly</li>
|
|
1572
|
-
<li>Float && < 0 : move it relatively to the left from the defualt</li>
|
|
1573
|
-
</ul></li>
|
|
1574
|
-
<li>dx: length of the legend line (not used if mark).
|
|
1575
|
-
<ul>
|
|
1576
|
-
<li>nil : internally determined</li>
|
|
1577
|
-
<li>Float && > 0 : set explicitly</li>
|
|
1578
|
-
</ul></li>
|
|
1579
|
-
<li>vy: vy of the legend (not used if !first -- see below).
|
|
1580
|
-
<ul>
|
|
1581
|
-
<li>nil : internally determined</li>
|
|
1582
|
-
<li>Float && > 0 : set explicitly</li>
|
|
1583
|
-
<li>Float && < 0 : move it relatively lower from the defualt</li>
|
|
1584
|
-
</ul></li>
|
|
1585
|
-
<li>first : if false, vy is moved lower relatively from the previous vy.</li>
|
|
1586
|
-
<li>mark_size : size of the mark. if nil, size is used.</li>
|
|
1587
|
-
</ul>
|
|
1588
|
-
<dl>
|
|
1589
|
-
<dt><h4><a name="label-89" id="label-89"><code>quasi_log_levels_z(<var>vals</var>, <var>nlev</var>=<var>nil</var>, <var>max</var>=<var>nil</var>, <var>min</var>=<var>nil</var>, <var>cycle</var>=<var>1</var>)</code></a></h4></dt><!-- RDLabel: "quasi_log_levels_z" -->
|
|
1590
|
-
</dl>
|
|
1591
|
-
<p>Driver of quasi_log_levels with data values</p>
|
|
1592
|
-
<dl>
|
|
1593
|
-
<dt><h4><a name="label-90" id="label-90"><code>quasi_log_levels(<var>lev0</var>, <var>lev1</var>, <var>cycle</var>=<var>1</var>)</code></a></h4></dt><!-- RDLabel: "quasi_log_levels" -->
|
|
1594
|
-
</dl>
|
|
1595
|
-
<p>Returns approximately log-scaled contour/tone levels as well as
|
|
1596
|
-
major/minor flags for contours. No DCL call is made in here.</p>
|
|
1597
|
-
<ul>
|
|
1598
|
-
<li>cycle (Integer; 1, or 2 or 3) : number of level in one-order.
|
|
1599
|
-
e.g. 1,10,100,.. for cycle==1; 1,3,10,30,.. for cycle==2;
|
|
1600
|
-
1,2,5,10,20,50,.. for cycle==3</li>
|
|
1601
|
-
<li>lev0, lev1 (Float) : levels are set between this two params
|
|
1602
|
-
<ul>
|
|
1603
|
-
<li>if lev0 & lev1 > 0 : positive only</li>
|
|
1604
|
-
<li>if lev0 & lev1 < 0 : negative only</li>
|
|
1605
|
-
<li>if lev0 * lev1 < 0 : both positive and negative
|
|
1606
|
-
(usig +-[lev0.abs,lev1.abs])</li>
|
|
1607
|
-
</ul></li>
|
|
1608
|
-
</ul>
|
|
1609
|
-
<p>RETURN VALUE:</p>
|
|
1610
|
-
<ul>
|
|
1611
|
-
<li>[ levels, mjmn ]</li>
|
|
1612
|
-
</ul>
|
|
1613
|
-
|
|
1614
|
-
</body>
|
|
1615
|
-
</html>
|