11.07.2015 Views

PyClimate 1.1. A set of C and Python routines for the ... - Starship

PyClimate 1.1. A set of C and Python routines for the ... - Starship

PyClimate 1.1. A set of C and Python routines for the ... - Starship

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

XG_44_44 |hgt_e<strong>of</strong>s | : 1.00e-00 dG:-1.11022e-16G_45_45 |hgt_e<strong>of</strong>s | : 1.00e+00 dG: 2.22045e-16G_46_46 |hgt_e<strong>of</strong>s | : 1.00e+00 dG: 0.00000e+00XG_47_47 |hgt_e<strong>of</strong>s | : 1.00e-00 dG:-1.11022e-16RMS Error |hgt_lambdas | : 0.00e+00The first character <strong>of</strong> each file may be a blank (no difference detected) or a X, inwhich case, a difference has been detected. Most <strong>of</strong>ten, <strong>the</strong>se differences are not important,<strong>and</strong> <strong>the</strong>y are simply due to <strong>the</strong> fact that <strong>the</strong> control used is <strong>of</strong> <strong>the</strong> type ifrms!=0.0):, which is not accurate enough. The second column shows which is <strong>the</strong>measure used to evaluate <strong>the</strong> differences. Usually, RMS errors are used, but congruencecoefficients (G i i) are also used to evaluate errors in EOFs (<strong>and</strong> related quantities,like PCs, expansion coefficients <strong>for</strong> SVD analysis or heterogeneous <strong>and</strong> homogeneouscorrelation maps) due to <strong>the</strong> fact that both <strong>and</strong> are valid solutions <strong>of</strong> <strong>the</strong> eigenvalueproblem. The third column states <strong>the</strong> name <strong>of</strong> <strong>the</strong> netCDF variable which holds<strong>the</strong> reference data <strong>and</strong> <strong>the</strong> fourth column shows <strong>the</strong> value <strong>of</strong> <strong>the</strong> error measure (RMS orcongruence coefficient). For <strong>the</strong> special case <strong>of</strong> congruence coefficients, a last column(dG) shows <strong>the</strong> difference to let <strong>the</strong> user know <strong>the</strong> real difference <strong>for</strong> thoselines with a X as <strong>the</strong> first character.The new tests in version 1.1 have increased <strong>the</strong> size <strong>of</strong> reference.cdf to 1.6 Mb. There<strong>for</strong>e,it is not currently distributed with pyclimate, <strong>and</strong> <strong>the</strong> distribution still fits ina floppy disk (or two, if you download <strong>the</strong> reference file <strong>and</strong> gzip -9 it first). Thetest script can retrieve <strong>the</strong> file from <strong>the</strong> URL, <strong>and</strong>, additionally, <strong>the</strong> file can alwaysbe downloaded from <strong>the</strong> primary WEB server http://www.pyclimate.org.python pyclimatetest.py -g <strong>for</strong>ces <strong>the</strong> retrieval <strong>of</strong> <strong>the</strong> reference file fromits URL.python pyclimatetest.py will usually be called without comm<strong>and</strong> line arguments,<strong>and</strong> it per<strong>for</strong>ms <strong>the</strong> comparisons. However, if a user detects that with herhardware or s<strong>of</strong>tware she is getting different results (<strong>for</strong> instance, phases in EOFs) <strong>and</strong>she prefers to have her own reference.cdf file, she can use <strong>the</strong> comm<strong>and</strong> lineoption -o to overwrite <strong>the</strong> reference file. It is not advisable to do this unless <strong>the</strong> correctness<strong>of</strong> pyclimate has been examined at least once after <strong>the</strong> primary installation inthat plat<strong>for</strong>m.2.4 ExamplesThe previous manual included some examples on <strong>the</strong> use <strong>of</strong> <strong>the</strong> code. However, wehave removed those examples from <strong>the</strong> current version <strong>of</strong> <strong>the</strong> manual to save sometrees. They can be found at <strong>the</strong> directory examples <strong>of</strong> <strong>the</strong> distribution, <strong>and</strong> you canprint <strong>the</strong>m, if you don’t mind using paper. Ano<strong>the</strong>r different source <strong>of</strong> in<strong>for</strong>mation on<strong>the</strong> use <strong>of</strong> <strong>the</strong> package can be found in <strong>the</strong> pyclimatettest.py file, which coversmost <strong>of</strong> <strong>the</strong> functions in <strong>the</strong> package, using real–life data <strong>set</strong>s.4

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!