gphys 1.2.2.1 → 1.4.3

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.
Files changed (405) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +8 -17
  3. data/.rspec +2 -0
  4. data/.travis.yml +3 -0
  5. data/ChangeLog +5762 -753
  6. data/LICENSE.txt +30 -18
  7. data/Rakefile +1 -0
  8. data/bin/console +14 -0
  9. data/bin/gpcat +43 -2
  10. data/bin/gpcut +16 -0
  11. data/bin/gpvect +167 -15
  12. data/bin/gpview +254 -51
  13. data/bin/setup +7 -0
  14. data/dim_op.c +1220 -0
  15. data/doc/attribute.html +19 -0
  16. data/doc/attributenetcdf.html +15 -0
  17. data/doc/axis.html +387 -0
  18. data/doc/coordmapping.html +111 -0
  19. data/doc/coordtransform.html +36 -0
  20. data/doc/dclext.html +821 -0
  21. data/doc/derivative/gphys-derivative.html +100 -0
  22. data/doc/derivative/index.html +21 -0
  23. data/doc/derivative/index.rd +14 -0
  24. data/doc/derivative/math-doc/document.pdf +0 -0
  25. data/doc/derivative/math-doc/document.tex +158 -0
  26. data/doc/derivative/math-doc/document/document.css +30 -0
  27. data/doc/derivative/math-doc/document/document.html +57 -0
  28. data/doc/derivative/math-doc/document/images.aux +1 -0
  29. data/doc/derivative/math-doc/document/images.log +385 -0
  30. data/doc/derivative/math-doc/document/images.pl +186 -0
  31. data/doc/derivative/math-doc/document/images.tex +364 -0
  32. data/doc/derivative/math-doc/document/img1.png +0 -0
  33. data/doc/derivative/math-doc/document/img10.png +0 -0
  34. data/doc/derivative/math-doc/document/img11.png +0 -0
  35. data/doc/derivative/math-doc/document/img12.png +0 -0
  36. data/doc/derivative/math-doc/document/img13.png +0 -0
  37. data/doc/derivative/math-doc/document/img14.png +0 -0
  38. data/doc/derivative/math-doc/document/img15.png +0 -0
  39. data/doc/derivative/math-doc/document/img16.png +0 -0
  40. data/doc/derivative/math-doc/document/img17.png +0 -0
  41. data/doc/derivative/math-doc/document/img18.png +0 -0
  42. data/doc/derivative/math-doc/document/img19.png +0 -0
  43. data/doc/derivative/math-doc/document/img2.png +0 -0
  44. data/doc/derivative/math-doc/document/img20.png +0 -0
  45. data/doc/derivative/math-doc/document/img21.png +0 -0
  46. data/doc/derivative/math-doc/document/img22.png +0 -0
  47. data/doc/derivative/math-doc/document/img23.png +0 -0
  48. data/doc/derivative/math-doc/document/img24.png +0 -0
  49. data/doc/derivative/math-doc/document/img25.png +0 -0
  50. data/doc/derivative/math-doc/document/img26.png +0 -0
  51. data/doc/derivative/math-doc/document/img27.png +0 -0
  52. data/doc/derivative/math-doc/document/img28.png +0 -0
  53. data/doc/derivative/math-doc/document/img29.png +0 -0
  54. data/doc/derivative/math-doc/document/img3.png +0 -0
  55. data/doc/derivative/math-doc/document/img30.png +0 -0
  56. data/doc/derivative/math-doc/document/img4.png +0 -0
  57. data/doc/derivative/math-doc/document/img5.png +0 -0
  58. data/doc/derivative/math-doc/document/img6.png +0 -0
  59. data/doc/derivative/math-doc/document/img7.png +0 -0
  60. data/doc/derivative/math-doc/document/img8.png +0 -0
  61. data/doc/derivative/math-doc/document/img9.png +0 -0
  62. data/doc/derivative/math-doc/document/index.html +57 -0
  63. data/doc/derivative/math-doc/document/labels.pl +13 -0
  64. data/doc/derivative/math-doc/document/next.png +0 -0
  65. data/doc/derivative/math-doc/document/next_g.png +0 -0
  66. data/doc/derivative/math-doc/document/node1.html +238 -0
  67. data/doc/derivative/math-doc/document/node2.html +75 -0
  68. data/doc/derivative/math-doc/document/prev.png +0 -0
  69. data/doc/derivative/math-doc/document/prev_g.png +0 -0
  70. data/doc/derivative/math-doc/document/up.png +0 -0
  71. data/doc/derivative/math-doc/document/up_g.png +0 -0
  72. data/doc/derivative/numru-derivative.html +158 -0
  73. data/doc/ep_flux/ep_flux.html +469 -0
  74. data/doc/ep_flux/ggraph_on_merdional_section.html +71 -0
  75. data/doc/ep_flux/index.html +31 -0
  76. data/doc/ep_flux/index.rd +24 -0
  77. data/doc/ep_flux/math-doc/document.pdf +0 -0
  78. data/doc/ep_flux/math-doc/document.tex +2018 -0
  79. data/doc/ep_flux/math-doc/document/WARNINGS +1 -0
  80. data/doc/ep_flux/math-doc/document/contents.png +0 -0
  81. data/doc/ep_flux/math-doc/document/crossref.png +0 -0
  82. data/doc/ep_flux/math-doc/document/document.css +30 -0
  83. data/doc/ep_flux/math-doc/document/document.html +101 -0
  84. data/doc/ep_flux/math-doc/document/images.aux +1 -0
  85. data/doc/ep_flux/math-doc/document/images.log +1375 -0
  86. data/doc/ep_flux/math-doc/document/images.pl +1328 -0
  87. data/doc/ep_flux/math-doc/document/images.tex +1471 -0
  88. data/doc/ep_flux/math-doc/document/img1.png +0 -0
  89. data/doc/ep_flux/math-doc/document/img10.png +0 -0
  90. data/doc/ep_flux/math-doc/document/img100.png +0 -0
  91. data/doc/ep_flux/math-doc/document/img101.png +0 -0
  92. data/doc/ep_flux/math-doc/document/img102.png +0 -0
  93. data/doc/ep_flux/math-doc/document/img103.png +0 -0
  94. data/doc/ep_flux/math-doc/document/img104.png +0 -0
  95. data/doc/ep_flux/math-doc/document/img105.png +0 -0
  96. data/doc/ep_flux/math-doc/document/img106.png +0 -0
  97. data/doc/ep_flux/math-doc/document/img107.png +0 -0
  98. data/doc/ep_flux/math-doc/document/img108.png +0 -0
  99. data/doc/ep_flux/math-doc/document/img109.png +0 -0
  100. data/doc/ep_flux/math-doc/document/img11.png +0 -0
  101. data/doc/ep_flux/math-doc/document/img110.png +0 -0
  102. data/doc/ep_flux/math-doc/document/img111.png +0 -0
  103. data/doc/ep_flux/math-doc/document/img112.png +0 -0
  104. data/doc/ep_flux/math-doc/document/img113.png +0 -0
  105. data/doc/ep_flux/math-doc/document/img114.png +0 -0
  106. data/doc/ep_flux/math-doc/document/img115.png +0 -0
  107. data/doc/ep_flux/math-doc/document/img116.png +0 -0
  108. data/doc/ep_flux/math-doc/document/img117.png +0 -0
  109. data/doc/ep_flux/math-doc/document/img118.png +0 -0
  110. data/doc/ep_flux/math-doc/document/img119.png +0 -0
  111. data/doc/ep_flux/math-doc/document/img12.png +0 -0
  112. data/doc/ep_flux/math-doc/document/img120.png +0 -0
  113. data/doc/ep_flux/math-doc/document/img121.png +0 -0
  114. data/doc/ep_flux/math-doc/document/img122.png +0 -0
  115. data/doc/ep_flux/math-doc/document/img123.png +0 -0
  116. data/doc/ep_flux/math-doc/document/img124.png +0 -0
  117. data/doc/ep_flux/math-doc/document/img125.png +0 -0
  118. data/doc/ep_flux/math-doc/document/img126.png +0 -0
  119. data/doc/ep_flux/math-doc/document/img127.png +0 -0
  120. data/doc/ep_flux/math-doc/document/img128.png +0 -0
  121. data/doc/ep_flux/math-doc/document/img129.png +0 -0
  122. data/doc/ep_flux/math-doc/document/img13.png +0 -0
  123. data/doc/ep_flux/math-doc/document/img130.png +0 -0
  124. data/doc/ep_flux/math-doc/document/img131.png +0 -0
  125. data/doc/ep_flux/math-doc/document/img132.png +0 -0
  126. data/doc/ep_flux/math-doc/document/img133.png +0 -0
  127. data/doc/ep_flux/math-doc/document/img134.png +0 -0
  128. data/doc/ep_flux/math-doc/document/img135.png +0 -0
  129. data/doc/ep_flux/math-doc/document/img136.png +0 -0
  130. data/doc/ep_flux/math-doc/document/img137.png +0 -0
  131. data/doc/ep_flux/math-doc/document/img138.png +0 -0
  132. data/doc/ep_flux/math-doc/document/img139.png +0 -0
  133. data/doc/ep_flux/math-doc/document/img14.png +0 -0
  134. data/doc/ep_flux/math-doc/document/img140.png +0 -0
  135. data/doc/ep_flux/math-doc/document/img141.png +0 -0
  136. data/doc/ep_flux/math-doc/document/img142.png +0 -0
  137. data/doc/ep_flux/math-doc/document/img143.png +0 -0
  138. data/doc/ep_flux/math-doc/document/img144.png +0 -0
  139. data/doc/ep_flux/math-doc/document/img145.png +0 -0
  140. data/doc/ep_flux/math-doc/document/img146.png +0 -0
  141. data/doc/ep_flux/math-doc/document/img147.png +0 -0
  142. data/doc/ep_flux/math-doc/document/img148.png +0 -0
  143. data/doc/ep_flux/math-doc/document/img149.png +0 -0
  144. data/doc/ep_flux/math-doc/document/img15.png +0 -0
  145. data/doc/ep_flux/math-doc/document/img150.png +0 -0
  146. data/doc/ep_flux/math-doc/document/img151.png +0 -0
  147. data/doc/ep_flux/math-doc/document/img152.png +0 -0
  148. data/doc/ep_flux/math-doc/document/img153.png +0 -0
  149. data/doc/ep_flux/math-doc/document/img154.png +0 -0
  150. data/doc/ep_flux/math-doc/document/img155.png +0 -0
  151. data/doc/ep_flux/math-doc/document/img156.png +0 -0
  152. data/doc/ep_flux/math-doc/document/img157.png +0 -0
  153. data/doc/ep_flux/math-doc/document/img158.png +0 -0
  154. data/doc/ep_flux/math-doc/document/img159.png +0 -0
  155. data/doc/ep_flux/math-doc/document/img16.png +0 -0
  156. data/doc/ep_flux/math-doc/document/img160.png +0 -0
  157. data/doc/ep_flux/math-doc/document/img161.png +0 -0
  158. data/doc/ep_flux/math-doc/document/img162.png +0 -0
  159. data/doc/ep_flux/math-doc/document/img163.png +0 -0
  160. data/doc/ep_flux/math-doc/document/img164.png +0 -0
  161. data/doc/ep_flux/math-doc/document/img165.png +0 -0
  162. data/doc/ep_flux/math-doc/document/img166.png +0 -0
  163. data/doc/ep_flux/math-doc/document/img167.png +0 -0
  164. data/doc/ep_flux/math-doc/document/img168.png +0 -0
  165. data/doc/ep_flux/math-doc/document/img169.png +0 -0
  166. data/doc/ep_flux/math-doc/document/img17.png +0 -0
  167. data/doc/ep_flux/math-doc/document/img170.png +0 -0
  168. data/doc/ep_flux/math-doc/document/img171.png +0 -0
  169. data/doc/ep_flux/math-doc/document/img172.png +0 -0
  170. data/doc/ep_flux/math-doc/document/img173.png +0 -0
  171. data/doc/ep_flux/math-doc/document/img174.png +0 -0
  172. data/doc/ep_flux/math-doc/document/img175.png +0 -0
  173. data/doc/ep_flux/math-doc/document/img176.png +0 -0
  174. data/doc/ep_flux/math-doc/document/img177.png +0 -0
  175. data/doc/ep_flux/math-doc/document/img178.png +0 -0
  176. data/doc/ep_flux/math-doc/document/img179.png +0 -0
  177. data/doc/ep_flux/math-doc/document/img18.png +0 -0
  178. data/doc/ep_flux/math-doc/document/img180.png +0 -0
  179. data/doc/ep_flux/math-doc/document/img181.png +0 -0
  180. data/doc/ep_flux/math-doc/document/img182.png +0 -0
  181. data/doc/ep_flux/math-doc/document/img183.png +0 -0
  182. data/doc/ep_flux/math-doc/document/img184.png +0 -0
  183. data/doc/ep_flux/math-doc/document/img185.png +0 -0
  184. data/doc/ep_flux/math-doc/document/img186.png +0 -0
  185. data/doc/ep_flux/math-doc/document/img187.png +0 -0
  186. data/doc/ep_flux/math-doc/document/img188.png +0 -0
  187. data/doc/ep_flux/math-doc/document/img189.png +0 -0
  188. data/doc/ep_flux/math-doc/document/img19.png +0 -0
  189. data/doc/ep_flux/math-doc/document/img190.png +0 -0
  190. data/doc/ep_flux/math-doc/document/img191.png +0 -0
  191. data/doc/ep_flux/math-doc/document/img192.png +0 -0
  192. data/doc/ep_flux/math-doc/document/img193.png +0 -0
  193. data/doc/ep_flux/math-doc/document/img194.png +0 -0
  194. data/doc/ep_flux/math-doc/document/img195.png +0 -0
  195. data/doc/ep_flux/math-doc/document/img196.png +0 -0
  196. data/doc/ep_flux/math-doc/document/img197.png +0 -0
  197. data/doc/ep_flux/math-doc/document/img198.png +0 -0
  198. data/doc/ep_flux/math-doc/document/img199.png +0 -0
  199. data/doc/ep_flux/math-doc/document/img2.png +0 -0
  200. data/doc/ep_flux/math-doc/document/img20.png +0 -0
  201. data/doc/ep_flux/math-doc/document/img200.png +0 -0
  202. data/doc/ep_flux/math-doc/document/img21.png +0 -0
  203. data/doc/ep_flux/math-doc/document/img22.png +0 -0
  204. data/doc/ep_flux/math-doc/document/img23.png +0 -0
  205. data/doc/ep_flux/math-doc/document/img24.png +0 -0
  206. data/doc/ep_flux/math-doc/document/img25.png +0 -0
  207. data/doc/ep_flux/math-doc/document/img26.png +0 -0
  208. data/doc/ep_flux/math-doc/document/img27.png +0 -0
  209. data/doc/ep_flux/math-doc/document/img28.png +0 -0
  210. data/doc/ep_flux/math-doc/document/img29.png +0 -0
  211. data/doc/ep_flux/math-doc/document/img3.png +0 -0
  212. data/doc/ep_flux/math-doc/document/img30.png +0 -0
  213. data/doc/ep_flux/math-doc/document/img31.png +0 -0
  214. data/doc/ep_flux/math-doc/document/img32.png +0 -0
  215. data/doc/ep_flux/math-doc/document/img33.png +0 -0
  216. data/doc/ep_flux/math-doc/document/img34.png +0 -0
  217. data/doc/ep_flux/math-doc/document/img35.png +0 -0
  218. data/doc/ep_flux/math-doc/document/img36.png +0 -0
  219. data/doc/ep_flux/math-doc/document/img37.png +0 -0
  220. data/doc/ep_flux/math-doc/document/img38.png +0 -0
  221. data/doc/ep_flux/math-doc/document/img39.png +0 -0
  222. data/doc/ep_flux/math-doc/document/img4.png +0 -0
  223. data/doc/ep_flux/math-doc/document/img40.png +0 -0
  224. data/doc/ep_flux/math-doc/document/img41.png +0 -0
  225. data/doc/ep_flux/math-doc/document/img42.png +0 -0
  226. data/doc/ep_flux/math-doc/document/img43.png +0 -0
  227. data/doc/ep_flux/math-doc/document/img44.png +0 -0
  228. data/doc/ep_flux/math-doc/document/img45.png +0 -0
  229. data/doc/ep_flux/math-doc/document/img46.png +0 -0
  230. data/doc/ep_flux/math-doc/document/img47.png +0 -0
  231. data/doc/ep_flux/math-doc/document/img48.png +0 -0
  232. data/doc/ep_flux/math-doc/document/img49.png +0 -0
  233. data/doc/ep_flux/math-doc/document/img5.png +0 -0
  234. data/doc/ep_flux/math-doc/document/img50.png +0 -0
  235. data/doc/ep_flux/math-doc/document/img51.png +0 -0
  236. data/doc/ep_flux/math-doc/document/img52.png +0 -0
  237. data/doc/ep_flux/math-doc/document/img53.png +0 -0
  238. data/doc/ep_flux/math-doc/document/img54.png +0 -0
  239. data/doc/ep_flux/math-doc/document/img55.png +0 -0
  240. data/doc/ep_flux/math-doc/document/img56.png +0 -0
  241. data/doc/ep_flux/math-doc/document/img57.png +0 -0
  242. data/doc/ep_flux/math-doc/document/img58.png +0 -0
  243. data/doc/ep_flux/math-doc/document/img59.png +0 -0
  244. data/doc/ep_flux/math-doc/document/img6.png +0 -0
  245. data/doc/ep_flux/math-doc/document/img60.png +0 -0
  246. data/doc/ep_flux/math-doc/document/img61.png +0 -0
  247. data/doc/ep_flux/math-doc/document/img62.png +0 -0
  248. data/doc/ep_flux/math-doc/document/img63.png +0 -0
  249. data/doc/ep_flux/math-doc/document/img64.png +0 -0
  250. data/doc/ep_flux/math-doc/document/img65.png +0 -0
  251. data/doc/ep_flux/math-doc/document/img66.png +0 -0
  252. data/doc/ep_flux/math-doc/document/img67.png +0 -0
  253. data/doc/ep_flux/math-doc/document/img68.png +0 -0
  254. data/doc/ep_flux/math-doc/document/img69.png +0 -0
  255. data/doc/ep_flux/math-doc/document/img7.png +0 -0
  256. data/doc/ep_flux/math-doc/document/img70.png +0 -0
  257. data/doc/ep_flux/math-doc/document/img71.png +0 -0
  258. data/doc/ep_flux/math-doc/document/img72.png +0 -0
  259. data/doc/ep_flux/math-doc/document/img73.png +0 -0
  260. data/doc/ep_flux/math-doc/document/img74.png +0 -0
  261. data/doc/ep_flux/math-doc/document/img75.png +0 -0
  262. data/doc/ep_flux/math-doc/document/img76.png +0 -0
  263. data/doc/ep_flux/math-doc/document/img77.png +0 -0
  264. data/doc/ep_flux/math-doc/document/img78.png +0 -0
  265. data/doc/ep_flux/math-doc/document/img79.png +0 -0
  266. data/doc/ep_flux/math-doc/document/img8.png +0 -0
  267. data/doc/ep_flux/math-doc/document/img80.png +0 -0
  268. data/doc/ep_flux/math-doc/document/img81.png +0 -0
  269. data/doc/ep_flux/math-doc/document/img82.png +0 -0
  270. data/doc/ep_flux/math-doc/document/img83.png +0 -0
  271. data/doc/ep_flux/math-doc/document/img84.png +0 -0
  272. data/doc/ep_flux/math-doc/document/img85.png +0 -0
  273. data/doc/ep_flux/math-doc/document/img86.png +0 -0
  274. data/doc/ep_flux/math-doc/document/img87.png +0 -0
  275. data/doc/ep_flux/math-doc/document/img88.png +0 -0
  276. data/doc/ep_flux/math-doc/document/img89.png +0 -0
  277. data/doc/ep_flux/math-doc/document/img9.png +0 -0
  278. data/doc/ep_flux/math-doc/document/img90.png +0 -0
  279. data/doc/ep_flux/math-doc/document/img91.png +0 -0
  280. data/doc/ep_flux/math-doc/document/img92.png +0 -0
  281. data/doc/ep_flux/math-doc/document/img93.png +0 -0
  282. data/doc/ep_flux/math-doc/document/img94.png +0 -0
  283. data/doc/ep_flux/math-doc/document/img95.png +0 -0
  284. data/doc/ep_flux/math-doc/document/img96.png +0 -0
  285. data/doc/ep_flux/math-doc/document/img97.png +0 -0
  286. data/doc/ep_flux/math-doc/document/img98.png +0 -0
  287. data/doc/ep_flux/math-doc/document/img99.png +0 -0
  288. data/doc/ep_flux/math-doc/document/index.html +101 -0
  289. data/doc/ep_flux/math-doc/document/internals.pl +258 -0
  290. data/doc/ep_flux/math-doc/document/labels.pl +265 -0
  291. data/doc/ep_flux/math-doc/document/next.png +0 -0
  292. data/doc/ep_flux/math-doc/document/next_g.png +0 -0
  293. data/doc/ep_flux/math-doc/document/node1.html +104 -0
  294. data/doc/ep_flux/math-doc/document/node10.html +164 -0
  295. data/doc/ep_flux/math-doc/document/node11.html +86 -0
  296. data/doc/ep_flux/math-doc/document/node12.html +166 -0
  297. data/doc/ep_flux/math-doc/document/node13.html +897 -0
  298. data/doc/ep_flux/math-doc/document/node14.html +1065 -0
  299. data/doc/ep_flux/math-doc/document/node15.html +72 -0
  300. data/doc/ep_flux/math-doc/document/node16.html +81 -0
  301. data/doc/ep_flux/math-doc/document/node2.html +82 -0
  302. data/doc/ep_flux/math-doc/document/node3.html +91 -0
  303. data/doc/ep_flux/math-doc/document/node4.html +149 -0
  304. data/doc/ep_flux/math-doc/document/node5.html +330 -0
  305. data/doc/ep_flux/math-doc/document/node6.html +99 -0
  306. data/doc/ep_flux/math-doc/document/node7.html +98 -0
  307. data/doc/ep_flux/math-doc/document/node8.html +83 -0
  308. data/doc/ep_flux/math-doc/document/node9.html +140 -0
  309. data/doc/ep_flux/math-doc/document/prev.png +0 -0
  310. data/doc/ep_flux/math-doc/document/prev_g.png +0 -0
  311. data/doc/ep_flux/math-doc/document/up.png +0 -0
  312. data/doc/ep_flux/math-doc/document/up_g.png +0 -0
  313. data/doc/gdir.html +412 -0
  314. data/doc/gdir_client.html +16 -0
  315. data/doc/gdir_connect_ftp-like.html +61 -0
  316. data/doc/gdir_server.html +45 -0
  317. data/doc/ggraph.html +1119 -0
  318. data/doc/gpcat.html +45 -0
  319. data/doc/gpcut.html +47 -0
  320. data/doc/gphys.html +624 -0
  321. data/doc/gphys_fft.html +324 -0
  322. data/doc/gphys_grads_io.html +69 -0
  323. data/doc/gphys_grib_io.html +82 -0
  324. data/doc/gphys_io.html +183 -0
  325. data/doc/gphys_io_common.html +18 -0
  326. data/doc/gphys_netcdf_io.html +283 -0
  327. data/doc/gplist.html +24 -0
  328. data/doc/gpmath.html +52 -0
  329. data/doc/gpmaxmin.html +32 -0
  330. data/doc/gpprint.html +35 -0
  331. data/doc/gpview.html +349 -0
  332. data/doc/grads2nc_with_gphys.html +21 -0
  333. data/doc/grads_gridded.html +307 -0
  334. data/doc/grib.html +149 -0
  335. data/doc/grid.html +224 -0
  336. data/doc/index.html +145 -0
  337. data/doc/index.rd +138 -0
  338. data/doc/netcdf_convention.html +136 -0
  339. data/doc/unumeric.html +176 -0
  340. data/doc/update +69 -0
  341. data/doc/update_rdoc +8 -0
  342. data/doc/varray.html +299 -0
  343. data/doc/varraycomposite.html +67 -0
  344. data/ext_init.c +1 -0
  345. data/extconf.rb +16 -6
  346. data/gphys.gemspec +33 -26
  347. data/interpo.c +1 -1
  348. data/lib/numru/dclext.rb +718 -546
  349. data/lib/numru/derivative.rb +2 -0
  350. data/lib/numru/ganalysis.rb +38 -0
  351. data/lib/numru/ganalysis/beta_plane.rb +103 -0
  352. data/lib/numru/ganalysis/eof.rb +3 -2
  353. data/lib/numru/ganalysis/fitting.rb +559 -0
  354. data/lib/numru/ganalysis/histogram.rb +36 -19
  355. data/lib/numru/ganalysis/log_p.rb +130 -0
  356. data/lib/numru/ganalysis/met.rb +396 -2
  357. data/lib/numru/ganalysis/met_z.rb +300 -0
  358. data/lib/numru/ganalysis/planet.rb +17 -7
  359. data/lib/numru/ganalysis/qg.rb +685 -0
  360. data/lib/numru/ganalysis/sigma_coord.rb +90 -0
  361. data/lib/numru/gdir.rb +2 -1
  362. data/lib/numru/ggraph.rb +204 -60
  363. data/lib/numru/ggraph_on_merdional_section.rb +1 -1
  364. data/lib/numru/gphys.rb +6 -0
  365. data/lib/numru/gphys/assoccoords.rb +18 -3
  366. data/lib/numru/gphys/axis.rb +209 -8
  367. data/lib/numru/gphys/derivative.rb +11 -0
  368. data/lib/numru/gphys/gphys.rb +539 -48
  369. data/lib/numru/gphys/gphys_dim_op.rb +331 -0
  370. data/lib/numru/gphys/gphys_fft.rb +48 -2
  371. data/lib/numru/gphys/gphys_io.rb +241 -13
  372. data/lib/numru/gphys/gphys_netcdf_io.rb +77 -39
  373. data/lib/numru/gphys/gphys_nusdas_io.rb +3 -0
  374. data/lib/numru/gphys/grib.rb +133 -54
  375. data/lib/numru/gphys/grib_params.rb +26 -3
  376. data/lib/numru/gphys/grid.rb +75 -34
  377. data/lib/numru/gphys/interpolate.rb +24 -10
  378. data/lib/numru/gphys/mdstorage.rb +160 -0
  379. data/lib/numru/gphys/netcdf_convention.rb +4 -2
  380. data/lib/numru/gphys/subsetmapping.rb +0 -1
  381. data/lib/numru/gphys/unumeric.rb +50 -5
  382. data/lib/numru/gphys/varray.rb +15 -30
  383. data/lib/numru/gphys/varraycomposite.rb +107 -24
  384. data/lib/numru/gphys/varraynetcdf.rb +9 -3
  385. data/lib/numru/gphys/version.rb +5 -0
  386. data/sample/druby_cli1.rb +2 -0
  387. data/sample/druby_cli2.rb +0 -6
  388. data/sample/druby_serv2.rb +0 -13
  389. data/spec/gphys_spec.rb +11 -0
  390. data/spec/spec_helper.rb +2 -0
  391. data/test/test_assoccoords.rb +102 -0
  392. data/test/test_axis.rb +61 -0
  393. data/test/test_fitting.rb +116 -0
  394. data/test/test_gphys.rb +20 -0
  395. data/test/test_met_z.rb +96 -0
  396. data/test/test_sigma_coord.rb +50 -0
  397. data/{test → test_old}/eof_slp.rb +0 -0
  398. data/{test → test_old}/mltbit.dat +0 -0
  399. data/{test → test_old}/test_ep_flux.rb +0 -0
  400. data/{test → test_old}/test_multibitIO.rb +0 -0
  401. metadata +530 -191
  402. data/README.md +0 -29
  403. data/lib/gphys.rb +0 -2
  404. data/lib/numru/dclext_datetime_ax.rb +0 -220
  405. data/lib/version.rb +0 -3
@@ -0,0 +1,16 @@
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>../bin/gdir_client</title>
8
+ </head>
9
+ <body>
10
+ <h1><a name="label:0" id="label:0">gdir_client</a></h1><!-- RDLabel: "gdir_client" -->
11
+ <p>A client of gdir_server using irb.</p>
12
+ <p>This command is just equal to</p>
13
+ <pre>irb -r numru/gdir_connect_ftp-like</pre>
14
+
15
+ </body>
16
+ </html>
@@ -0,0 +1,61 @@
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/gdir_connect_ftp-like.rb</title>
8
+ </head>
9
+ <body>
10
+ <h1><a name="label:0" id="label:0">irb start-up program numru/gdir_connect_ftp-like</a></h1><!-- RDLabel: "irb start-up program numru/gdir_connect_ftp-like" -->
11
+ <p>A ftp-like client of GPhys directory services (e.g., gdir_server.rb).
12
+ Connection is based on dRuby.</p>
13
+ <h2><a name="label:1" id="label:1">Usage</a></h2><!-- RDLabel: "Usage" -->
14
+ <pre>At command line,
15
+ % irb --noinspect -r numru/gphys_connect_ftp-like
16
+ then type in the URI of the server.</pre>
17
+ <h2><a name="label:2" id="label:2">Available Methods</a></h2><!-- RDLabel: "Available Methods" -->
18
+ <pre>Native methods:
19
+ help help_more ls dir pwd cd(path) open(name) readtext(name)
20
+ start_dcl(iws=1, iwidth=500, iheight=500, uzfact=1.0)
21
+
22
+ All GGraph methods:
23
+ contour(gphys) line(gphys) etc.etc.</pre>
24
+ <h2><a name="label:3" id="label:3">Methods</a></h2><!-- RDLabel: "Methods" -->
25
+ <dl>
26
+ <dt><h4><a name="label:4" id="label:4"><code>help</code></a></h4></dt><!-- RDLabel: "help" -->
27
+ <dd>
28
+ <p>Show a help message</p></dd>
29
+ <dt><h4><a name="label:5" id="label:5"><code>help_more</code></a></h4></dt><!-- RDLabel: "help_more" -->
30
+ <dd>
31
+ <p>Show a further help message</p></dd>
32
+ <dt><h4><a name="label:6" id="label:6"><code>ls</code></a></h4></dt><!-- RDLabel: "ls" -->
33
+ <dd>
34
+ <p>List the directory.</p></dd>
35
+ <dt><h4><a name="label:7" id="label:7"><code>dir</code></a><!-- RDLabel: "dir" -->
36
+ <dt><h4><a name="label:8" id="label:8"><code>ls_l</code></a></h4></dt><!-- RDLabel: "ls_l" -->
37
+ <dd>
38
+ <p>Like ls but with a long descriptive format</p></dd>
39
+ <dt><h4><a name="label:9" id="label:9"><code>pwd</code></a></h4></dt><!-- RDLabel: "pwd" -->
40
+ <dd>
41
+ <p>Prints the path of the current directory.</p></dd>
42
+ <dt><h4><a name="label:10" id="label:10"><code>open(<var>name</var>)</code></a></h4></dt><!-- RDLabel: "open" -->
43
+ <dd>
44
+ <p>opens a GPhys, where name is a variable name in the current directory
45
+ (shown by ls without trailing "/").</p></dd>
46
+ <dt><h4><a name="label:11" id="label:11"><code>readtext(<var>name</var>)</code></a></h4></dt><!-- RDLabel: "readtext" -->
47
+ <dd>
48
+ <p>prints the contents of the text file in the current directory
49
+ (shown by ls with remarks as such).</p></dd>
50
+ <dt><h4><a name="label:12" id="label:12"><code>start_dcl(<var>iws</var>=<var>1</var>, <var>iwidth</var>=<var>500</var>, <var>iheight</var>=<var>500</var>, <var>uzfact</var>=<var>1</var>.<var>0</var>)</code></a></h4></dt><!-- RDLabel: "start_dcl" -->
51
+ <dd>
52
+ <p>To start RubyDCL (Calls DCL.gropn(iws)).
53
+ Call this before using GGraph module functions such as contour.</p></dd>
54
+ <dt><h4><a name="label:13" id="label:13"><code>contour</code></a><!-- RDLabel: "contour" -->
55
+ <dt><h4><a name="label:14" id="label:14"><code>line</code></a></h4></dt><!-- RDLabel: "line" -->
56
+ <dd>
57
+ <p>GGraph methods</p></dd>
58
+ </dl>
59
+
60
+ </body>
61
+ </html>
@@ -0,0 +1,45 @@
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>../bin/gdir_server</title>
8
+ </head>
9
+ <body>
10
+ <h1><a name="label-0" id="label-0">NAME</a></h1><!-- RDLabel: "NAME" -->
11
+ <p>gdir_server - A stand-alone server program to provide a directory service of GPhys</p>
12
+ <h1><a name="label-1" id="label-1">SYNOPSIS</a></h1><!-- RDLabel: "SYNOPSIS" -->
13
+ <pre>% gdir_server top_dir [[host:]port] [-a allowed_address]..</pre>
14
+ <h1><a name="label-2" id="label-2">DESCRIPTION</a></h1><!-- RDLabel: "DESCRIPTION" -->
15
+ <p>A stand-alone server program to provide a directory service of GPhys
16
+ objects by using GDir.</p>
17
+ <h1><a name="label-3" id="label-3">OPTION</a></h1><!-- RDLabel: "OPTION" -->
18
+ <dl>
19
+ <dt><h4><a name="label-4" id="label-4">top_dir:</a></h4></dt><!-- RDLabel: "top_dir:" -->
20
+ <dd>
21
+ can be ".", "/", or whatever directory in your files system.
22
+ </dd>
23
+ <dt><h4><a name="label-5" id="label-5">host:</a></h4></dt><!-- RDLabel: "host:" -->
24
+ <dd>
25
+ host address (name or ip) -- use it if you want to specify
26
+ explicitly, such as "localhost", which is useful for ssh port forwarding.
27
+ </dd>
28
+ <dt><h4><a name="label-6" id="label-6">port:</a></h4></dt><!-- RDLabel: "port:" -->
29
+ <dd>
30
+ the port number you want to assign (internally determined
31
+ if not specified). A complete URI is printed if the server is started.
32
+ </dd>
33
+ <dt><h4><a name="label-7" id="label-7">-a:</a></h4></dt><!-- RDLabel: "-a:" -->
34
+ <dd>
35
+ <p>limits accesses from remote hosts only to the ones specified.
36
+ Can be repeated multiple times. (Need the space between '-a' and the rest)</p>
37
+ <pre>% gdir_server . 12345
38
+ % gdir_server . localhost:12345 -a all
39
+ % gdir_server . -a hoge.hero.org -a localhost
40
+ % gdir_server . 12345 -a '192.168.1.*' -a localhost</pre>
41
+ </dd>
42
+ </dl>
43
+
44
+ </body>
45
+ </html>
@@ -0,0 +1,1119 @@
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::<!-- Reference, RDLabel "flow_vect" doesn't exist --><em class="label-not-found">flow_vect</em><!-- Reference end --></li>
97
+ </ul></li>
98
+ </ul>
99
+ <h1><a name="label-2" id="label-2">module NumRu::GGraph</a></h1><!-- RDLabel: "module NumRu::GGraph" -->
100
+ <p>A graphic library for GPhys using RubyDCL.</p>
101
+ <p>This module uses GPhys but is not a part of it.
102
+ More specifically, even though this module is included in
103
+ the GPhys distribution, the class NumRu::GPhys knows nothing about it,
104
+ and GGraph accesses GPhys only though public methods.
105
+ So GGraph is not an insider, and you can make another graphic
106
+ library if you like.</p>
107
+ <h2><a name="label-3" id="label-3">Module Functions</a></h2><!-- RDLabel: "Module Functions" -->
108
+ <dl>
109
+ <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" -->
110
+ <dd>
111
+ <p>Sets the strings to appear in the bottom margin.</p>
112
+ <p>This method sets margin widths as DCL.slmgn(xl, xr, yb, yt),
113
+ and sets the 1st and 2nd margin strings as <code>program</code>
114
+ and <code>data</code>.</p>
115
+ <p>ARGUMENTS</p>
116
+ <ul>
117
+ <li>program (String or nil) : String to be put on the left side in
118
+ the bottom margin. This is meant to represent the name of the
119
+ execution program. Therefore, if it is nil, the full path of
120
+ $0 is used.</li>
121
+ <li>data_source (String or nil) : String to be put on the right side in
122
+ the bottom margin. This is meant to represent the data file name or the
123
+ directory in which the data are situated.
124
+ If nil, the full path of the current directory is used
125
+ (but nothing is shown if it is equal to the directory of the program).</li>
126
+ <li>date (true, false, nil) : whether to put todays date --
127
+ true: always, nil: if program.length is short enough, false: never</li>
128
+ <li>char_height (Float or nil) : height of the string to appear
129
+ in the V coordinate. If nil, internally defined.</li>
130
+ <li>xl, xr, yb, yl (Float --- nil is available for yb) : margin
131
+ size in the V coordinate. The margin is set as
132
+ DCL.slmgn(xl, xr, yb, yt). If <code>yb</code> is nil, it is determined
133
+ internally as <code>2.0 * char_height</code>.</li>
134
+ </ul></dd>
135
+ <dt><h4><a name="label-5" id="label-5"><code>title(<var>string</var>)</code></a></h4></dt><!-- RDLabel: "title" -->
136
+ <dd>
137
+ <p>Shows title by <code>DCL.uxmttl('t',string,0.0)</code>.
138
+ Graphic methods such as <a href="#label-25">contour</a> calls this by default.</p>
139
+ <p>RETURN VALUE</p>
140
+ <ul>
141
+ <li>nil</li>
142
+ </ul></dd>
143
+ <dt><h4><a name="label-6" id="label-6"><code>annotate(<var>str_ary</var>)</code></a></h4></dt><!-- RDLabel: "annotate" -->
144
+ <dd>
145
+ <p>Show texts on the right margin of the viewport.
146
+ Graphic methods such as <a href="#label-25">contour</a> calls this by default.</p>
147
+ <p>ARGUMENTS</p>
148
+ <ul>
149
+ <li>str_ary (Array of String) :</li>
150
+ </ul>
151
+ <p>RETURN VALUE</p>
152
+ <ul>
153
+ <li>nil</li>
154
+ </ul></dd>
155
+ <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" -->
156
+ <dd>
157
+ <p>Define a figure by setting viewport, window, and coordinate transform
158
+ id (itr) from two 1D VArrays <code>xax</code> and <code>yax</code> (which are
159
+ not needed if a map projection is specified with the optional
160
+ parameter 'itr').</p>
161
+ <p><code>DCL.grfrm</code> or <code>DCL.grfig</code> is called depending options provided.</p>
162
+ <p>ARGUMENTS</p>
163
+ <ul>
164
+ <li>xax (VArray): (Used only if not map projection)
165
+ A VArray representing the x (horizontal) coordinate
166
+ of the figure.
167
+ The x range of the window (UXMIN &amp; UYMAX in DCL) are determined
168
+ with the max and min of <code>xax.val</code>. By default,
169
+ the min and max values are assigned to the left and right
170
+ boundaries, respectively, but it is reversed if <code>xax</code> has
171
+ a 'positive' attribute and its value is 'down' etc (see <code>options</code>).</li>
172
+ <li>yax (VArray): (Used only if not map projection)
173
+ Similar to <code>xax</code> but for the y (vertical) coordinate
174
+ of the figure.</li>
175
+ <li><p>options (Hash) : options to change the default behavior if specified.
176
+ It is a Hash with option names (String) as keys and their values.
177
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
178
+ so you can shorten the keys (by omitting tails) as long as it is
179
+ unambiguous.</p>
180
+ <pre>option name default value # description:
181
+ "new_frame" true # whether to define a new frame by DCL.grfrm
182
+ # (otherwise, DCL.grfig is called)
183
+ "no_new_fig" false # If true, neither DCL.grfrm nor DCL.grfig
184
+ # is called (overrides new_frame) -- Then, you need
185
+ # to call one of them in advance. Convenient to set
186
+ # DCL parameters that are reset by grfrm or grfig.
187
+ "itr" 1 # coordinate transformation number
188
+ "viewport" [0.2, 0.8, 0.2, 0.8] # [vxmin, vxmax, vymin, vymax]
189
+ "eqdistvpt" false # modify viewport to equidistant for x and y
190
+ # (only for itr=1--4)
191
+ "window" nil # (for itr&lt;10,&gt;50) [uxmin, uxmax, uymin, uymax],
192
+ # each element allowed nil (only for itr&lt;5,&gt;50)
193
+ "xreverse" "positive:down,units:hPa" # (for itr&lt;10,&gt;50) Assign
194
+ # max value to UXMIN and min value to UXMAX if
195
+ # condition is satisfied (nil:never, true:always,
196
+ # String: when an attibute has the value specified
197
+ # ("key:value,key:value,..")
198
+ "yreverse" "positive:down,units:hPa" # (for itr&lt;10,&gt;50) Assign
199
+ # max value to UYMIN and min value to UYMAX if
200
+ # condition is satisfied (nil:never, true:always,
201
+ # String: when an attibute has the value specified
202
+ # ("key:value,key:value,..")
203
+ "round0" false # expand window range to good numbers (effective
204
+ # only to internal window settings)
205
+ "round1" false # expand window range to good numbers (effective
206
+ # even when "window" is explicitly specified)
207
+ "similar" nil # (for rectangular curvilinear coordinate only)
208
+ # 3-element float array for similar transformation
209
+ # in a rectangular curvilinear coordinate, which
210
+ # is fed in DCL:grssim:[simfac,vxoff,vyoff],where
211
+ # simfac and [vxoff,vyoff] represent scaling
212
+ # factor and origin shift, respectively.
213
+ "map_axis" nil # (for all map projections) 3-element float
214
+ # array to be fed in DCL::umscnt: [uxc, uxy, rot],
215
+ # where [uxc, uyc] represents the tangential point
216
+ # (or the pole at top side for cylindrical
217
+ # projections), and rot represents the rotation
218
+ # angle. If nil, internally determined. (units:
219
+ # degrees)
220
+ "map_radius" nil # (for itr&gt;=20: conical/azimuhal map
221
+ # projections) raidus around the tangential point.
222
+ # (units: degrees)
223
+ "map_fit" nil # (Only for itr=10(cylindrical) and 11 (Mercator))
224
+ # true: fit the plot to the data window
225
+ # (overrides map_window and map_axis); false: do
226
+ # not fit (then map_window and map_axis are used);
227
+ # nil: true if itr==10, false if itr==11
228
+ "map_rsat" nil # (Only for itr=30) satellite distance from the
229
+ # earth's center (Parameter "RSAT" for sgpack)
230
+ "map_window" [-180, 180, -75, 75] # (for itr&lt;20: cylindrical
231
+ # map projections) lon-lat window [lon_min,
232
+ # lon_max, lat_min, lat_max ] to draw the map
233
+ # (units: degres)
234
+ "help" false # show help message if true</pre></li>
235
+ </ul>
236
+ <p>RETURN VALUE</p>
237
+ <ul>
238
+ <li>nil</li>
239
+ </ul>
240
+ <p>POSSIBLE EXCEPTIONS</p>
241
+ <ul>
242
+ <li>those from NumRu::DCL if any / TypeError if any</li>
243
+ <li>options has a key that does not match any of the option names.</li>
244
+ <li>options has a key that is ambiguous</li>
245
+ </ul></dd>
246
+ <dt><h4><a name="label-8" id="label-8"><code>set_fig(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_fig" -->
247
+ <dd>
248
+ <p>Change the default option values for <a href="#label-7">fig</a>.</p>
249
+ <p>ARGUMENTS</p>
250
+ <ul>
251
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-7">fig</a>.</li>
252
+ </ul>
253
+ <p>RETURN VALUE</p>
254
+ <ul>
255
+ <li>a Hash containing the values replaced (the ones before calling this
256
+ method)</li>
257
+ </ul>
258
+ <p>POSSIBLE EXCEPTIONS</p>
259
+ <ul>
260
+ <li>see <a href="#label-7">fig</a>.</li>
261
+ </ul></dd>
262
+ <dt><h4><a name="label-9" id="label-9"><code>next_fig(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_fig" -->
263
+ <dd>
264
+ <p>Set the option values effective only in the next call of <a href="#label-7">fig</a>
265
+ (cleared then).</p>
266
+ <p>These value are overwritten if specified explicitly in the next
267
+ call of <a href="#label-7">fig</a>.</p>
268
+ <p>ARGUMENTS</p>
269
+ <ul>
270
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-7">fig</a>.</li>
271
+ </ul>
272
+ <p>RETURN VALUE</p>
273
+ <ul>
274
+ <li>nil</li>
275
+ </ul>
276
+ <p>POSSIBLE EXCEPTIONS</p>
277
+ <ul>
278
+ <li>see <a href="#label-7">fig</a>.</li>
279
+ </ul></dd>
280
+ <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" -->
281
+ <dd>
282
+ <p>Draw axes using (by default) info in <code>xax</code> and <code>yax</code> if non-nil.</p>
283
+ <p>ARGUMENTS</p>
284
+ <ul>
285
+ <li>xax (nil or VArray): if non-nil, attributes 'long_name' and 'units'
286
+ are read to define <code>xtitle</code> and <code>xunits</code> (see below).
287
+ These are overwritten by explicitly specifying <code>xtitle</code> and
288
+ <code>xunits</code>.</li>
289
+ <li>yax (nil or VArray): if non-nil, attributes 'long_name' and 'units'
290
+ are read to define <code>ytitle</code> and <code>yunits</code> (see below).
291
+ These are overwritten by explicitly specifying <code>ytitle</code> and
292
+ <code>yunits</code>.</li>
293
+ <li><p>options (Hash) : options to change the default behavior if specified.
294
+ It is a Hash with option names (String) as keys and their values.
295
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
296
+ so you can shorten the keys (by omitting tails) as long as it is
297
+ unambiguous.</p>
298
+ <pre>option name default value # description:
299
+ "xside" "tb" # Where to draw xaxes (combination of t, b and u)
300
+ "yside" "lr" # Where to draw yaxes (combination of l, r and u)
301
+ "xtitle" nil # Title of x axis (if nil, internally determined)
302
+ "ytitle" nil # Title of y axis (if nil, internally determined)
303
+ "xunits" nil # Units of x axis (if nil, internally determined)
304
+ "yunits" nil # Units of y axis (if nil, internally determined)
305
+ "xtickint" nil # Interval of x axis tickmark
306
+ # (if nil, internally determined)
307
+ "ytickint" nil # Interval of y axis tickmark
308
+ # (if nil, internally determined)
309
+ "xlabelint" nil # Interval of x axis label
310
+ # (if nil, internally determined)
311
+ "ylabelint" nil # Interval of y axis label
312
+ # (if nil, internally determined)
313
+ "xloglabelall" false # Show lavels for all log-level tick marks
314
+ # (x-axes) (e.g.,1000,900,800,... inseatd of
315
+ # 1000,500,200,...)
316
+ "yloglabelall" false # Show lavels for all log-level tick marks
317
+ # (y-axes) (e.g.,1000,900,800,... inseatd of
318
+ # 1000,500,200,...)
319
+ "xmaplabel" nil # If "lon"("lat"), use
320
+ # DCLExt::lon_ax(DCLExt::lat_ax) to draw xaxes;
321
+ # otherwise, DCL::usxaxs is used.
322
+ "ymaplabel" nil # If "lon"("lat"), use
323
+ # DCLExt::lon_ax(DCLExt::lat_ax) to draw yaxes;
324
+ # otherwise, DCL::usyaxs is used.
325
+ "time_ax" nil # Type of calendar-type time axis: nil (=&gt; auto
326
+ # slection), false (do not use the time axis even
327
+ # if the units of the axis is a time one with since
328
+ # field), "h" (=&gt; like nil, but always use the
329
+ # hour-resolving datetime_ax method in
330
+ # dclext_datetime_ax.rb), or "ymd" (=&gt; like "h" but
331
+ # for y-m-d type using DCL.uc[xy]acl)
332
+ "help" false # show help message if true</pre></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>those from NumRu::DCL if any / TypeError if any</li>
341
+ <li>options has a key that does not match any of the option names.</li>
342
+ <li>options has a key that is ambiguous</li>
343
+ </ul></dd>
344
+ <dt><h4><a name="label-11" id="label-11"><code>set_axes(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_axes" -->
345
+ <dd>
346
+ <p>Change the default option values for <a href="#label-10">axes</a>.</p>
347
+ <p>ARGUMENTS</p>
348
+ <ul>
349
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-10">axes</a>.</li>
350
+ </ul>
351
+ <p>RETURN VALUE</p>
352
+ <ul>
353
+ <li>a Hash containing the values replaced (the ones before calling this
354
+ method)</li>
355
+ </ul>
356
+ <p>POSSIBLE EXCEPTIONS</p>
357
+ <ul>
358
+ <li>see <a href="#label-10">axes</a>.</li>
359
+ </ul></dd>
360
+ <dt><h4><a name="label-12" id="label-12"><code>next_axes(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_axes" -->
361
+ <dd>
362
+ <p>Set the option values effective only in the next call of <a href="#label-10">axes</a>
363
+ (cleared then).</p>
364
+ <p>These value are overwritten if specified explicitly in the next
365
+ call of <a href="#label-10">axes</a>.</p>
366
+ <p>ARGUMENTS</p>
367
+ <ul>
368
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-10">axes</a>.</li>
369
+ </ul>
370
+ <p>RETURN VALUE</p>
371
+ <ul>
372
+ <li>nil</li>
373
+ </ul>
374
+ <p>POSSIBLE EXCEPTIONS</p>
375
+ <ul>
376
+ <li>see <a href="#label-10">axes</a>.</li>
377
+ </ul></dd>
378
+ <dt><h4><a name="label-13" id="label-13"><code>sim_trn?</code></a></h4></dt><!-- RDLabel: "sim_trn?" -->
379
+ <dd>
380
+ <p>Returns whether the current coordinate transformation is a rectangular
381
+ curvelinear coordinate. A coordinate transformation must have been
382
+ established with <a href="#label-7">fig</a> or <code>DCL::grstrf</code>.
383
+ Mainly for internal usage, but a user can use it too.</p>
384
+ <p>RETURN VALUE</p>
385
+ <ul>
386
+ <li>true or false</li>
387
+ </ul></dd>
388
+ <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" -->
389
+ <dd>
390
+ <p>Draw boundaries in a polar coordinate.</p>
391
+ <p>ARGUMENTS</p>
392
+ <ul>
393
+ <li>xax (VArray): Grid points of the radial coordinate.</li>
394
+ <li>yax (VArray): Grid points of the azimuthal coordinate.</li>
395
+ </ul>
396
+ <p>RETURN VALUE</p>
397
+ <ul>
398
+ <li>nil</li>
399
+ </ul></dd>
400
+ <dt><h4><a name="label-15" id="label-15"><code>map_trn?</code></a></h4></dt><!-- RDLabel: "map_trn?" -->
401
+ <dd>
402
+ <p>Returns whether the current coordinate transformation is a map projection.</p>
403
+ <p>A coordinate transformation must have been established
404
+ with <a href="#label-7">fig</a> or <code>DCL::grstrf</code>.
405
+ Mainly for internal usage, but a user can use it too.</p>
406
+ <p>RETURN VALUE</p>
407
+ <ul>
408
+ <li>true or false</li>
409
+ </ul></dd>
410
+ <dt><h4><a name="label-16" id="label-16"><code>map(<var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "map" -->
411
+ <dd>
412
+ <p>(For map projection) Draws map grid and/or lim and/or coast lines etc.</p>
413
+ <p>ARGUMENTS</p>
414
+ <ul>
415
+ <li><p>options (Hash) : options to change the default behavior if specified.
416
+ It is a Hash with option names (String) as keys and their values.
417
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
418
+ so you can shorten the keys (by omitting tails) as long as it is
419
+ unambiguous.</p>
420
+ <pre>option name default value # description:
421
+ "lim" true # draw map lim (t or f)
422
+ "grid" true # draw map grid (t or f)
423
+ "vpt_boundary" false # draw viewport boundaries (f, t or
424
+ # 1,2,3.., representing the line width)
425
+ "wwd_boundary" false # draw worksation window boundaries (f, t
426
+ # or 1,2,3.., representing the line width)
427
+ "fill" false # fill the map if coast_world or coast_japan is
428
+ # true (t or f)
429
+ "coast_world" false # draw world coast lines (t or f)
430
+ "border_world" false # draw nation borders (t or f)
431
+ "plate_world" false # draw plate boundaries (t or f)
432
+ "state_usa" false # draw state boundaries of US (t or f)
433
+ "coast_japan" false # draw japanese coast lines (t or f)
434
+ "pref_japan" false # draw japanese prefecture boundaries (t or
435
+ # f)
436
+ "dgridmj" nil # the interval between the major lines of
437
+ # latitudes and longitudes. If nil, internally
438
+ # determined. (units: degrees) (this is a UMPACK
439
+ # parameter, which is nullified when uminit or
440
+ # grfrm is called)
441
+ "dgridmn" nil # the interval between the minor lines of
442
+ # latitudes and longitudes. If nil, internally
443
+ # determined. (units: degrees) (this is a UMPACK
444
+ # parameter, which is nullified when uminit or
445
+ # grfrm is called)
446
+ "help" false # show help message if true</pre></li>
447
+ </ul>
448
+ <p>RETURN VALUE</p>
449
+ <ul>
450
+ <li>nil</li>
451
+ </ul>
452
+ <p>POSSIBLE EXCEPTIONS</p>
453
+ <ul>
454
+ <li>if called when the coordinate tansformation has not been established or
455
+ the transformation is not a map projection.</li>
456
+ <li>those from NumRu::DCL if any / TypeError if any</li>
457
+ <li>options has a key that does not match any of the option names.</li>
458
+ <li>options has a key that is ambiguous</li>
459
+ </ul></dd>
460
+ <dt><h4><a name="label-17" id="label-17"><code>set_map(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_map" -->
461
+ <dd>
462
+ <p>Change the default option values for <a href="#label-16">map</a>.</p>
463
+ <p>ARGUMENTS</p>
464
+ <ul>
465
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-16">map</a>.</li>
466
+ </ul>
467
+ <p>RETURN VALUE</p>
468
+ <ul>
469
+ <li>a Hash containing the values replaced (the ones before calling this
470
+ method)</li>
471
+ </ul>
472
+ <p>POSSIBLE EXCEPTIONS</p>
473
+ <ul>
474
+ <li>see <a href="#label-16">map</a>.</li>
475
+ </ul></dd>
476
+ <dt><h4><a name="label-18" id="label-18"><code>next_map(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_map" -->
477
+ <dd>
478
+ <p>Set the option values effective only in the next call of <a href="#label-16">map</a>
479
+ (cleared then).</p>
480
+ <p>These value are overwritten if specified explicitly in the next
481
+ call of <a href="#label-16">map</a>.</p>
482
+ <p>ARGUMENTS</p>
483
+ <ul>
484
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-16">map</a>.</li>
485
+ </ul>
486
+ <p>RETURN VALUE</p>
487
+ <ul>
488
+ <li>nil</li>
489
+ </ul>
490
+ <p>POSSIBLE EXCEPTIONS</p>
491
+ <ul>
492
+ <li>see <a href="#label-16">map</a>.</li>
493
+ </ul></dd>
494
+ <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" -->
495
+ <dd>
496
+ <p>Plot a poly-line by selecting the first dimension (with GPhys#first1D)
497
+ if <code>gphys</code> is more than 2D.</p>
498
+ <p>ARGUMENTS</p>
499
+ <ul>
500
+ <li>gphys (GPhys) : a GPhys whose data is plotted.</li>
501
+ <li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
502
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
503
+ the poly-line is drawn (overlaid to the exiting figure).</li>
504
+ <li><p>options (Hash) : options to change the default behavior if specified.
505
+ It is a Hash with option names (String) as keys and their values.
506
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
507
+ so you can shorten the keys (by omitting tails) as long as it is
508
+ unambiguous.</p>
509
+ <pre>option name default value # description:
510
+ "title" nil # Title of the figure(if nil, internally
511
+ # determined)
512
+ "annotate" true # if false, do not put texts on the right
513
+ # margin even when newframe==true
514
+ "exchange" false # whether to exchange x and y axes
515
+ "index" 1 # line/mark index
516
+ "type" 1 # line type
517
+ "label" nil # if a String is given, it is shown as the label
518
+ "max" nil # maximum data value
519
+ "min" nil # minimum data value
520
+ "legend" nil # legend to annotate the line type and index. nil
521
+ # (defalut -- do not show); a String as the legend;
522
+ # true to use the name of the GPhys as the legend
523
+ "legend_vx" nil # (effective if legend) viewport x values of
524
+ # the lhs of the legend line (positive float); or
525
+ # nil for automatic settting (shown to the right of
526
+ # vpt); or move it to the left relatively (negtive
527
+ # float)
528
+ "legend_dx" nil # (effective if legend) length of the legend
529
+ # line
530
+ "legend_vy" nil # (effective if legend) viewport y value of the
531
+ # legend (Float; or nil for automatic settting)
532
+ "legend_size" nil # (effective if legend) character size of the
533
+ # legend
534
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
535
+ # true, draws axes by temprarilly switching to
536
+ # itr=1 and calling GGraph::axes.
537
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
538
+ # subset the data before plotting (order applied:
539
+ # slice -&gt; cut -&gt; mean)
540
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
541
+ # method to subset the data before plotting (order
542
+ # applied: slice -&gt; cut -&gt; mean)
543
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
544
+ # take mean of the data before plotting (order
545
+ # applied: slice -&gt; cut -&gt; mean)
546
+ "help" false # show help message if true</pre></li>
547
+ </ul>
548
+ <p>RETURN VALUE</p>
549
+ <ul>
550
+ <li>nil</li>
551
+ </ul></dd>
552
+ <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" -->
553
+ <dd>
554
+ <p>Similar to <a href="#label-19">line</a> but plots marks instead of drawing a poly-line.</p>
555
+ <p>ARGUMENTS</p>
556
+ <ul>
557
+ <li>gphys (GPhys) : a GPhys whose data is plotted.</li>
558
+ <li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
559
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
560
+ the poly-line is drawn (overlaid to the exiting figure).</li>
561
+ <li><p>options (Hash) : options to change the default behavior if specified.
562
+ It is a Hash with option names (String) as keys and their values.
563
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
564
+ so you can shorten the keys (by omitting tails) as long as it is
565
+ unambiguous.</p>
566
+ <pre>option name default value # description:
567
+ "title" nil # Title of the figure(if nil, internally
568
+ # determined)
569
+ "annotate" true # if false, do not put texts on the right
570
+ # margin even when newframe==true
571
+ "exchange" false # whether to exchange x and y axes
572
+ "index" 1 # mark index
573
+ "type" 2 # mark type
574
+ "size" 0.01 # marks size
575
+ "max" nil # maximum data value
576
+ "min" nil # minimum data value
577
+ "legend" nil # legend to annotate the mark type, index, and
578
+ # size. nil (defalut -- do not to show); a String
579
+ # as the legend; true to use the name of the GPhys
580
+ # as the legend
581
+ "legend_vx" nil # (effective if legend) viewport x values of
582
+ # the lhs of the legend line (positive float); or
583
+ # nil for automatic settting (shown to the right of
584
+ # vpt); or move it to the left relatively (negtive
585
+ # float)
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 -&gt; cut -&gt; 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 -&gt; cut -&gt; 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 -&gt; cut -&gt; 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-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" -->
609
+ <dd>
610
+ <p>Scatter diagram (using uumrkz, as in <a href="#label-20">mark</a>).</p>
611
+ <p>ARGUMENTS</p>
612
+ <ul>
613
+ <li>fx, fy (GPhys) : x and y locations.</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.</p>
618
+ <pre>option name default value # description:
619
+ "title" "" # Title of the figure(if nil, internally determined)
620
+ "annotate" true # if false, do not put texts on the right
621
+ # margin even when newframe==true
622
+ "index" 1 # mark index
623
+ "type" 2 # mark type
624
+ "size" 0.01 # marks size
625
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
626
+ # true, draws axes by temprarilly switching to
627
+ # itr=1 and calling GGraph::axes.
628
+ "xintv" 1 # interval of data sampling in x
629
+ "yintv" 1 # interval of data sampling in y
630
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
631
+ # subset the data before plotting (order applied:
632
+ # slice -&gt; cut -&gt; mean)
633
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
634
+ # method to subset the data before plotting (order
635
+ # applied: slice -&gt; cut -&gt; mean)
636
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
637
+ # take mean of the data before plotting (order
638
+ # applied: slice -&gt; cut -&gt; mean)
639
+ "help" false # show help message if true</pre></li>
640
+ </ul></dd>
641
+ <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" -->
642
+ <dd>
643
+ <p>Scatter diagram colored by values.</p>
644
+ <p>Coloring is made with respoect to fz just like in (&lt;&lt;tone&gt;&gt;).
645
+ You can draw a color bar by calling (&lt;&lt;color_bar&gt;&gt;) after calling
646
+ this method.</p>
647
+ <p>ARGUMENTS</p>
648
+ <ul>
649
+ <li>fx, fy (GPhys) : x and y locations.</li>
650
+ <li>fz (GPhys) : value on which colors are based.</li>
651
+ <li>newframe (true/false) : if true, calls <a href="#label-7">fig</a>, <a href="#label-10">axes</a>,
652
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
653
+ the poly-line is drawn (overlaid to the exiting figure).</li>
654
+ <li><p>options (Hash) : options to change the default behavior if specified.</p>
655
+ <pre>option name default value # description:
656
+ "title" "" # Title of the figure(if nil, internally determined)
657
+ "annotate" true # if false, do not put texts on the right
658
+ # margin even when newframe==true
659
+ "index" 3 # mark index (1-9)
660
+ "type" 10 # mark type
661
+ "size" 0.01 # marks size
662
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
663
+ # true, draws axes by temprarilly switching to
664
+ # itr=1 and calling GGraph::axes.
665
+ "clr_min" nil # if an integer (in 10..99) is specified, used as
666
+ # the color number for the minimum data values.
667
+ # (the same can be done by setting the uepack
668
+ # parameter "icolor1")
669
+ "clr_max" nil # if an integer (in 10..99) is specified, used as
670
+ # the color number for the maximum data values.
671
+ # (the same can be done by setting the uepack
672
+ # parameter "icolor2")
673
+ "keep" false # Use the tone levels and patterns used previously
674
+ "min" nil # minimum tone level
675
+ "max" nil # maximum tone level
676
+ "nlev" nil # number of levels
677
+ "interval" nil # contour interval
678
+ "help" false # show help message if true
679
+ "log" nil # approximately log-scaled levels (by using
680
+ # DCLExt::quasi_log_levels)
681
+ "log_cycle" 3 # (if log) number of levels in one-order (1 or 2
682
+ # or 3)
683
+ "levels" nil # tone levels (Array/NArray of Numeric). Works
684
+ # together with patterns
685
+ "patterns" nil # Similar to the pattern option in (&lt;&lt;tone&gt;&gt;)),
686
+ # but here only the color part (4th and 5th
687
+ # digitgs) is used. -- e.g, pattern 38999
688
+ # --&gt; color 38.
689
+ "xintv" 1 # interval of data sampling in x
690
+ "yintv" 1 # interval of data sampling in y
691
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
692
+ # subset the data before plotting (order applied:
693
+ # slice -&gt; cut -&gt; mean)
694
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
695
+ # method to subset the data before plotting (order
696
+ # applied: slice -&gt; cut -&gt; mean)
697
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
698
+ # take mean of the data before plotting (order
699
+ # applied: slice -&gt; cut -&gt; mean)
700
+ "help" false # show help message if true</pre></li>
701
+ </ul></dd>
702
+ <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" -->
703
+ <dd>
704
+ <p>This method overlays mode vectors on scatter plots.
705
+ Call this method after scatter / color_scatter.</p>
706
+ <p>ARGUMENTS</p>
707
+ <ul>
708
+ <li>mean : this determines the center of vectors</li>
709
+ <li><p>modes : two dimensional mode vectors (e.g. EOF modes) of the shape [2,2], [2,1], or [2].</p>
710
+ <pre>the first mode is modes[true,0] and the second mode is modes[true,1].</pre></li>
711
+ <li><p>options (Hash) : options to change the default behavior if specified.</p>
712
+ <pre>option name default value # description:
713
+ 'lineindex' 1 # line index
714
+ 'linetype' 1 # line type
715
+ 'fact' 2 # scaling factor (line length = stddev * fact for each side)
716
+ 'style' 'line' # style of displaying modes (line, arrow, ellipse)</pre></li>
717
+ </ul></dd>
718
+ <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" -->
719
+ <dd>
720
+ <p>Calls <a href="#label-30">tone</a> and <a href="#label-25">contour</a> successively. You can
721
+ specify the options for any of these.</p>
722
+ <p>NOTE:</p>
723
+ <ul>
724
+ <li>The option keys that are not existent in these methods
725
+ are simply neglected -- thus no spell-check-like feedback
726
+ is made, contrary to the indivisual call of contour or tone.
727
+ Also, only the help menu of <a href="#label-30">tone</a> can be shown.</li>
728
+ <li>Requires numru-misc-0.0.6 or later.</li>
729
+ </ul></dd>
730
+ <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" -->
731
+ <dd>
732
+ <p>Contour plot by selecting the first 2 dimensions (with GPhys#first2D)
733
+ if <code>gphys</code> is more than 3D.</p>
734
+ <p>Contour levels are determined as follows:</p>
735
+ <ul>
736
+ <li>contour levels are set in this method if not set by
737
+ <a href="#label-26">set_contour_levels</a> or the option <code>"levels"</code> is specified
738
+ explicitly.</li>
739
+ <li>When contour levels are set in this method, the option <code>"levels"</code>
740
+ has the highest precedence. If it is specified, options
741
+ <code>"index"</code>, <code>"line_type"</code>, <code>"label"</code>, and <code>"label_height"</code>
742
+ are used.
743
+ If <code>"levels"</code> are not specified, contour levels with a linear
744
+ increment are set by using the options <code>"min"</code>, <code>"max"</code>,
745
+ <code>"nlev"</code>, <code>"interval"</code>, <code>"nozero"</code>, <code>"coloring"</code>,
746
+ <code>"clr_min"</code>, and <code>"clr_max"</code>, which are interpreted by
747
+ DCLExt::<!-- Reference, RDLabel "ud_set_linear_levs" doesn't exist --><em class="label-not-found">ud_set_linear_levs</em><!-- Reference end -->. The default values
748
+ of the linear level setting can be changed with
749
+ <a href="#label-28">set_linear_contour_options</a>.</li>
750
+ </ul>
751
+ <p>ARGUMENTS</p>
752
+ <ul>
753
+ <li>gphys (GPhys) : a GPhys whose data is plotted.</li>
754
+ <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>),
755
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
756
+ the poly-line is drawn (overlaid to the exiting figure).</li>
757
+ <li><p>options (Hash) : options to change the default behavior if specified.
758
+ It is a Hash with option names (String) as keys and their values.
759
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
760
+ so you can shorten the keys (by omitting tails) as long as it is
761
+ unambiguous.</p>
762
+ <pre>option name default value # description:
763
+ "title" nil # Title of the figure(if nil, internally
764
+ # determined)
765
+ "annotate" true # if false, do not put texts on the right
766
+ # margin even when newframe==true
767
+ "transpose" false # if true, exchange x and y axes
768
+ "exchange" false # same as the option transpose
769
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
770
+ # true, draws axes by temprarilly switching to
771
+ # itr=1 and calling GGraph::axes.
772
+ "keep" false # Use the contour levels used previously
773
+ "min" nil # minimum contour level
774
+ "max" nil # maximum contour level
775
+ "nlev" nil # number of levels
776
+ "interval" nil # contour interval
777
+ "nozero" nil # delete zero contour
778
+ "coloring" false # set color contours with ud_coloring
779
+ "clr_min" 13 # (if coloring) minimum color number for the
780
+ # minimum data values
781
+ "clr_max" 99 # (if coloring) maximum color number for the
782
+ # maximum data values
783
+ "help" false # show help message if true
784
+ "log" nil # approximately log-scaled levels (by using
785
+ # DCLExt::quasi_log_levels)
786
+ "log_cycle" 3 # (if log) number of levels in one-order (1 or 2
787
+ # or 3)
788
+ "levels" nil # contour levels (Array/NArray of Numeric)
789
+ "index" nil # (if levels) line index(es) (Array/NArray of
790
+ # integers, Integer, or nil)
791
+ "line_type" nil # (if levels) line type(s) (Array/NArray of
792
+ # integers, Integer, or nil)
793
+ "label" nil # (if levels) contour label(s) (Array/NArray of
794
+ # String, String, true, false, nil). nil is
795
+ # recommended.
796
+ "label_height" nil # (if levels) label height(s)
797
+ # (Array/NArray of Numeric, Numeric, or nil).
798
+ # nil is recommended.
799
+ "xintv" 1 # interval of data sampling in x
800
+ "yintv" 1 # interval of data sampling in y
801
+ "xcoord" nil # Name of the coordinate variable for x-axis
802
+ "ycoord" nil # Name of the coordinate variable for y-axis
803
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
804
+ # subset the data before plotting (order applied:
805
+ # slice -&gt; cut -&gt; mean)
806
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
807
+ # method to subset the data before plotting (order
808
+ # applied: slice -&gt; cut -&gt; mean)
809
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
810
+ # take mean of the data before plotting (order
811
+ # applied: slice -&gt; cut -&gt; mean)</pre></li>
812
+ </ul>
813
+ <p>RETURN VALUE</p>
814
+ <ul>
815
+ <li>nil</li>
816
+ </ul></dd>
817
+ <dt><h4><a name="label-26" id="label-26"><code>set_contour_levels(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_contour_levels" -->
818
+ <dd>
819
+ <p>Set contour levels for <a href="#label-25">contour</a> explicitly by values with the option <code>levels</code>.</p>
820
+ <p>ARGUMENTS</p>
821
+ <ul>
822
+ <li>options (Hash) : options to change the default behavior.
823
+ The option <code>"levels"</code> is mandatory (so it is not optional!).
824
+ Supported options are <code>"levels"</code>, <code>"index"</code>,
825
+ <code>"line_type"</code>, <code>"label"</code>, and <code>"label_height"</code>.
826
+ See <a href="#label-25">contour</a> for their description.</li>
827
+ </ul></dd>
828
+ <dt><h4><a name="label-27" id="label-27"><code>clear_contour_levels</code></a></h4></dt><!-- RDLabel: "clear_contour_levels" -->
829
+ <dd>
830
+ Clear contour levels set by <a href="#label-26">set_contour_levels</a>.</dd>
831
+ <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" -->
832
+ <dd>
833
+ <p>Change the default option values regarding linear contour level
834
+ setting in <a href="#label-25">contour</a>.</p>
835
+ <p>ARGUMENTS</p>
836
+ <ul>
837
+ <li>options (Hash) : The usage is the same as <code>options</code>
838
+ for <a href="#label-25">contour</a> but supported options here are limited to
839
+ <code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, <code>"interval"</code>,
840
+ <code>"nozero"</code>, <code>"coloring"</code>, <code>"clr_min"</code>, and <code>"clr_max"</code>.</li>
841
+ </ul>
842
+ <p>RETURN VALUE</p>
843
+ <ul>
844
+ <li>a Hash containing the values replaced (the ones before calling this
845
+ method)</li>
846
+ </ul></dd>
847
+ <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" -->
848
+ <dd>
849
+ Similar to <a href="#label-28">set_linear_contour_options</a> but the setting
850
+ is effective only for the next call of <a href="#label-25">contour</a>.</dd>
851
+ <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" -->
852
+ <dd>
853
+ <p>Color tone or shading by selecting the first 2 dimensions
854
+ (with GPhys#first2D) if <code>gphys</code> is more than 3D.</p>
855
+ <p>Tone levels are determined as follows:</p>
856
+ <ul>
857
+ <li>Tone levels are set in this method if not set by
858
+ <a href="#label-32">set_tone_levels</a> or the option <code>"levels"</code> (and
859
+ optionally, <code>"patterns"</code>) is (are) specified explicitly.</li>
860
+ <li>When contour levels &amp; patterns are set in this method,
861
+ <ul>
862
+ <li><code>"levels"</code> has the highest precedence. If it is specified,
863
+ tone levels and patterns are determined by DCLExt::<!-- Reference, RDLabel "ue_set_tone" doesn't exist --><em class="label-not-found">ue_set_tone</em><!-- Reference end -->.
864
+ Here, tone patterns can be specified with the option <code>"patterns"</code>.</li>
865
+ <li>Currently, option <code>"patterns"</code> is effective only if <code>"levels"</code>
866
+ is specified. Otherwise, it is ignored and patterns are
867
+ determined internally (by using DCL.uegtlb).</li>
868
+ <li>If not, a linear tone levels are set if <code>"ltone"=true</code>
869
+ (this is the default), or shading is made if <code>"ltone"=false</code>.
870
+ Shading is determined by following the parameters in the UDPACK
871
+ in DCL. Therefore, coloring is made if DCL.udpget('ltone')==true
872
+ regardless the option <code>"ltone"=false</code> here.
873
+ When linear levels are set in this method, options
874
+ <code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, and <code>"interval"</code>
875
+ are used if specified, which are interpreted by
876
+ DCLExt::<!-- Reference, RDLabel "ue_set_linear_levs" doesn't exist --><em class="label-not-found">ue_set_linear_levs</em><!-- Reference end -->.
877
+ Their default values can be changed by
878
+ <a href="#label-34">set_linear_tone_options</a>.</li>
879
+ </ul></li>
880
+ </ul>
881
+ <p>ARGUMENTS</p>
882
+ <ul>
883
+ <li>gphys (GPhys) : a GPhys whose data is plotted.</li>
884
+ <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>),
885
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
886
+ the poly-line is drawn (overlaid to the exiting figure).</li>
887
+ <li><p>options (Hash) : options to change the default behavior if specified.
888
+ It is a Hash with option names (String) as keys and their values.
889
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
890
+ so you can shorten the keys (by omitting tails) as long as it is
891
+ unambiguous.</p>
892
+ <pre>option name default value # description:
893
+ "title" nil # Title of the figure(if nil, internally
894
+ # determined)
895
+ "annotate" true # if false, do not put texts on the right
896
+ # margin even when newframe==true
897
+ "ltone" true # Same as udpack parameter ltone
898
+ "tonf" false # Use DCL.uetonf instead of DCL.uetone
899
+ "tonb" false # Use DCL.uetonb instead of DCL.uetone
900
+ "tonc" false # Use DCL.uetonc instead of DCL.uetone
901
+ "clr_min" nil # if an integer (in 10..99) is specified, used as
902
+ # the color number for the minimum data values.
903
+ # (the same can be done by setting the uepack
904
+ # parameter "icolor1")
905
+ "clr_max" nil # if an integer (in 10..99) is specified, used as
906
+ # the color number for the maximum data values.
907
+ # (the same can be done by setting the uepack
908
+ # parameter "icolor2")
909
+ "transpose" false # if true, exchange x and y axes
910
+ "exchange" false # same as the option transpose
911
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
912
+ # true, draws axes by temprarilly switching to
913
+ # itr=1 and calling GGraph::axes.
914
+ "keep" false # Use the tone levels and patterns used previously
915
+ "color_bar" false # Add a color bar: THIS IS ONLY FOR QUICK
916
+ # LOOK. Use the GGraph::color_bar method explicitly
917
+ # for full option control
918
+ "min" nil # minimum tone level
919
+ "max" nil # maximum tone level
920
+ "nlev" nil # number of levels
921
+ "interval" nil # contour interval
922
+ "help" false # show help message if true
923
+ "log" nil # approximately log-scaled levels (by using
924
+ # DCLExt::quasi_log_levels)
925
+ "log_cycle" 3 # (if log) number of levels in one-order (1 or 2
926
+ # or 3)
927
+ "levels" nil # tone levels (Array/NArray of Numeric). Works
928
+ # together with patterns
929
+ "patterns" nil # tone patters (Array/NArray of Numeric). Works
930
+ # together with levels
931
+ "xintv" 1 # interval of data sampling in x
932
+ "yintv" 1 # interval of data sampling in y
933
+ "xcoord" nil # Name of the coordinate variable for x-axis
934
+ "ycoord" nil # Name of the coordinate variable for y-axis
935
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
936
+ # subset the data before plotting (order applied:
937
+ # slice -&gt; cut -&gt; mean)
938
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
939
+ # method to subset the data before plotting (order
940
+ # applied: slice -&gt; cut -&gt; mean)
941
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
942
+ # take mean of the data before plotting (order
943
+ # applied: slice -&gt; cut -&gt; mean)</pre></li>
944
+ </ul>
945
+ <p>RETURN VALUE</p>
946
+ <ul>
947
+ <li>nil</li>
948
+ </ul></dd>
949
+ <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" -->
950
+ <dd>
951
+ <ul>
952
+ <li>Descroption:
953
+ Draws color bars. Calls <code>DCLext.color_bar</code>.</li>
954
+ </ul></dd>
955
+ <dt><h4><a name="label-32" id="label-32"><code>set_tone_levels(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_tone_levels" -->
956
+ <dd>
957
+ <p>Set tone levels for <a href="#label-30">tone</a> explicitly by values.</p>
958
+ <p>ARGUMENTS</p>
959
+ <ul>
960
+ <li>options (Hash) : options to change the default behavior.
961
+ Supported options are <code>"levels"</code> and <code>"patterns"</code>.
962
+ Both of them must be specified explicitly (so they are
963
+ not optional!).</li>
964
+ </ul></dd>
965
+ <dt><h4><a name="label-33" id="label-33"><code>clear_tone_levels</code></a></h4></dt><!-- RDLabel: "clear_tone_levels" -->
966
+ <dd>
967
+ Clear tone levels set by <a href="#label-32">set_tone_levels</a>.</dd>
968
+ <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" -->
969
+ <dd>
970
+ <p>Change the default option values regarding linear tone level
971
+ setting in <a href="#label-30">tone</a>.</p>
972
+ <p>ARGUMENTS</p>
973
+ <ul>
974
+ <li>options (Hash) : The usage is the same as <code>options</code>
975
+ for <a href="#label-30">tone</a> but supported options here are limited to
976
+ <code>"min"</code>, <code>"max"</code>, <code>"nlev"</code>, and <code>"interval"</code>.</li>
977
+ </ul>
978
+ <p>RETURN VALUE</p>
979
+ <ul>
980
+ <li>a Hash containing the values replaced (the ones before calling this
981
+ method)</li>
982
+ </ul></dd>
983
+ <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" -->
984
+ <dd>
985
+ Similar to <a href="#label-34">set_linear_tone_options</a> but the setting
986
+ is effective only for the next call of <a href="#label-30">tone</a>.</dd>
987
+ <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" -->
988
+ <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" -->
989
+ <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" -->
990
+ <dd>
991
+ <p>2-D vector plot using DCL_Ext::<!-- Reference, RDLabel "flow_vect" doesn't exist --><em class="label-not-found">flow_vect</em><!-- Reference end -->,
992
+ which scales vectors in physical ("U") coordinates.</p>
993
+ <p>ARGUMENTS</p>
994
+ <ul>
995
+ <li>fx, fy (GPhys) : represent vectors</li>
996
+ <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>),
997
+ <a href="#label-5">title</a>, and <a href="#label-6">annotate</a> internally; if false, only
998
+ the poly-line is drawn (overlaid to the exiting figure).</li>
999
+ <li><p>options (Hash) : options to change the default behavior if specified.
1000
+ It is a Hash with option names (String) as keys and their values.
1001
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
1002
+ so you can shorten the keys (by omitting tails) as long as it is
1003
+ unambiguous.</p>
1004
+ <pre>option name default value # description:
1005
+ "title" nil # Title of the figure(if nil, internally
1006
+ # determined)
1007
+ "annotate" true # if false, do not put texts on the right
1008
+ # margin even when newframe==true
1009
+ "transpose" false # if true, exchange x and y axes
1010
+ "exchange" false # same as the option transpose
1011
+ "map_axes" false # [USE IT ONLY WHEN itr=10 (cylindrical)] If
1012
+ # true, draws axes by temprarilly switching to
1013
+ # itr=1 and calling GGraph::axes.
1014
+ "flow_vect" true # If true, use DCLExt::flow_vect to draw
1015
+ # vectors; otherwise, DCL::ugvect is used.
1016
+ "flow_itr5" false # If true, use DCLExt::flow_itr5 to draw
1017
+ # vectors; otherwise, DCLExt::flow_vect or
1018
+ # DCL::ugvect is used.
1019
+ "keep" false # Use the same vector scaling as in the previous
1020
+ # call. -- Currently, works only when "flow_vect"
1021
+ # is true
1022
+ "xintv" 1 # (Effective only if flow_vect) interval of data
1023
+ # sampling in x
1024
+ "yintv" 1 # (Effective only if flow_vect) interval of data
1025
+ # sampling in y
1026
+ "factor" 1.0 # (Effective only if flow_vect) scaling factor to
1027
+ # strech/reduce the arrow lengths
1028
+ "unit_vect" false # Show the unit vector
1029
+ "max_unit_vect" false # (Effective only if flow_vect &amp;&amp;
1030
+ # unit_vect) If true, use the maximum arrows to
1031
+ # scale the unit vector; otherwise, normalize in V
1032
+ # coordinate.
1033
+ "ux_unit" nil # (If Numeric) length of the x direction unit
1034
+ # vector (precedence of this option is lower than
1035
+ # max_unit_vect)
1036
+ "uy_unit" nil # (If Numeric) length of the y direction unit
1037
+ # vector (precedence of this option is lower than
1038
+ # max_unit_vect)
1039
+ "help" false # show help message if true
1040
+ "xcoord" nil # Name of the coordinate variable for x-axis
1041
+ "ycoord" nil # Name of the coordinate variable for y-axis
1042
+ "slice" nil # An Array to be pathed to the GPhys#[] method to
1043
+ # subset the data before plotting (order applied:
1044
+ # slice -&gt; cut -&gt; mean)
1045
+ "cut" nil # An Array or Hash to be pathed to the GPhys#cut
1046
+ # method to subset the data before plotting (order
1047
+ # applied: slice -&gt; cut -&gt; mean)
1048
+ "mean" nil # An Array to be pathed to the GPhys#mean method to
1049
+ # take mean of the data before plotting (order
1050
+ # applied: slice -&gt; cut -&gt; mean)</pre></li>
1051
+ </ul>
1052
+ <p>RETURN VALUE</p>
1053
+ <ul>
1054
+ <li>nil</li>
1055
+ </ul></dd>
1056
+ <dt><h4><a name="label-39" id="label-39"><code>set_regression_line(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "set_regression_line" -->
1057
+ <dd>
1058
+ <p>Change the default option values for <a href="#label-41">regression_line</a>.</p>
1059
+ <p>ARGUMENTS</p>
1060
+ <ul>
1061
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-41">regression_line</a>.</li>
1062
+ </ul>
1063
+ <p>RETURN VALUE</p>
1064
+ <ul>
1065
+ <li>a Hash containing the values replaced (the ones before calling this
1066
+ method)</li>
1067
+ </ul></dd>
1068
+ <dt><h4><a name="label-40" id="label-40"><code>next_regression_line(<var>options</var>)</code></a></h4></dt><!-- RDLabel: "next_regression_line" -->
1069
+ <dd>
1070
+ <p>Set the option values effective only in the next call of <a href="#label-41">regression_line</a>
1071
+ (cleared then).</p>
1072
+ <p>These value are overwritten if specified explicitly in the next
1073
+ call of <a href="#label-41">regression_line</a>.</p>
1074
+ <p>ARGUMENTS</p>
1075
+ <ul>
1076
+ <li>options (Hash) : The usage is the same as <code>options</code> for <a href="#label-41">regression_line</a>.</li>
1077
+ </ul>
1078
+ <p>RETURN VALUE</p>
1079
+ <ul>
1080
+ <li>nil</li>
1081
+ </ul></dd>
1082
+ <dt><h4><a name="label-41" id="label-41"><code>regression_line(<var>x</var>,<var>y</var>, <var>options</var>=<var>nil</var>)</code></a></h4></dt><!-- RDLabel: "regression_line" -->
1083
+ <dd>
1084
+ <p>Draw a linear regression line in the current viewport.</p>
1085
+ <p>A figure must have been drawn. Good to call after <a href="#label-21">scatter</a> or
1086
+ <a href="#label-22">color_scatter</a>. You can also use this method after any
1087
+ scatter plot (passively under non-GPhys environment), since the
1088
+ argument x,y can be NArray etc unlike other draw methods in GGraph. </p>
1089
+ <p>ARGUMENTS</p>
1090
+ <ul>
1091
+ <li>x, y (GPhys or VArray or NArray or NArrayMiss or Array) : x and y values </li>
1092
+ <li><p>options (Hash) : options to change the default behavior if specified.
1093
+ It is a Hash with option names (String) as keys and their values.
1094
+ Options are interpreted by a NumRu::Misc::KeywordOptAutoHelp,
1095
+ so you can shorten the keys (by omitting tails) as long as it is
1096
+ unambiguous.</p>
1097
+ <pre>option name default value # description:
1098
+ "x_given_y" false # If false (default), regress y for given x.
1099
+ # If true, x given y.
1100
+ "annot_slope" nil # Whether to show the slope on the right
1101
+ # margin. nil: show when itr=1,4, do not show when
1102
+ # itr=2,3; true: show; false: not show
1103
+ "annot_intercept" false # [Meaningful only when itr=1 (linear
1104
+ # scaling plot)] if true, show the intercept on the
1105
+ # right margin
1106
+ "limit" false # If true, regression line is shown only over the
1107
+ # range between max and min of the independent
1108
+ # variable. If false, regression line is written
1109
+ # over the whole range of the independent variable
1110
+ "clip" true # If true, use DCL's clipping not to show the line
1111
+ # outside the viewport
1112
+ "index" 1 # line index
1113
+ "type" 1 # line type
1114
+ "help" false # show help message if true</pre></li>
1115
+ </ul></dd>
1116
+ </dl>
1117
+
1118
+ </body>
1119
+ </html>