为了清楚起见，ccc-gistemp 是 Python 中 GISTEMP 的重新实现。GISTEMP 是根据陆地和海洋表面温度记录重建全球历史温度记录。它产生了一个熟悉的历史温度图表
项目描述
CLEAR CLIMATE CODE GISTEMP README FOR RELEASE 0.6.1
Nick Barnes，气候代码基金会
David Jones，气候代码基金会
$日期：2011-06-01 16:08:26 -0400（2011 年 6 月 1 日，星期三） $
内容
1. 简介
2 . 依赖关系
3. 安装
4. 输入数据
5. 运行
6. 结果
7. 回归测试
A. 参考文献
B. 文档历史
C. 版权和许可
1. 简介
这是 Clear Climate Code GISTEMP 项目
(ccc-吉斯普）。
Clear Climate Code 重新实施了 GISTEMP（GISS 表面
温度分析系统），使其更加清晰。工作继续
使其更清晰和更易于访问。
ccc-gistemp 0.6.1 版是 ccc-gistemp 0.6 版的发布。
0.6 版的目的是通过以下方式使 ccc-gistemp 更有用：
- 允许更灵活地选择输入数据。例如：GHCN v3；
仅限 USHCN；仅限海洋。
- 允许在陆地和海洋
数据相结合的步骤中使用陆地掩膜。
- 在 NumPy 数组上使用。
- 添加 setup.py
此外，还有各种错误修复和清晰度改进。release-notes.txt
中更详细地描述了自早期版本以来的更改。更多信息的 URL： http: //clearclimatecode.org/ Clear Climate Code 网站和博客。
http://ccc-gistemp.googlecode.com/ ccc-gistemp 代码库。
2. 依赖项
你需要 Python 和可以运行它的机器，以及网络
连接；没有明确的操作系统或 CPU 架构
依赖性，因此“任何”操作系统或 CPU 都应该没问题。
Python 有几个版本。我们推荐使用 Python 2.6 或 Python
2.7，但 ccc-gistemp 应该适用于
2.x 分支（自 2.4 起）的任何 Python 版本。它不适用于 Python 3.x（
python.org 称之为“闪亮的新事物”）。对 Python 2.4（以及
在某种程度上 2.5）的支持仍然很脆弱，并且
在过去引起了一些问题。
代码应该在 OS X、FreeBSD、Windows 和可能的各种
其他类 Unix 操作系统。
需要网络连接才能下载输入文件（
只需完成一次），并从
结果中显示可选图形。如果您使用代理访问 Internet，则 Python 要求
设置“http_proxy”环境变量。代理需要
同时处理 HTTP 和 FTP 请求（这似乎会引起一些麻烦，
请参阅下面的“输入数据”以手动下载数据）。
Python 可能已经安装在你的机器上（例如，它
预装在 OS X 上），你可以使用
操作系统的包管理器来安装它；对于 Windows，您可以
从 http://www.python.org/download/ 下载安装程序。我们建议您使用
Python 2.x 系列的稳定生产版本（Python 3.x 将
不起作用）。
3. 安装
解压 ccc-gistemp-0.6.1.tar.gz。
4. INPUT DATA
ccc-gistemp 使用子目录 input/ 中的输入数据。该输入数据包括来自 GHCN、USHCN 和海面数据的温度记录的
大文件（几兆字节到几十兆字节），以及来自 GISS的附加温度记录和台站表的小文件。ccc-gistemp 包含代码 (tool/preflight.py) ，用于通过Internet从发起组织获取此数据。如果文件已经存在于 input/ 目录中，它将不会下载文件，因此如果您希望运行 ccc-gistemp 并更新
输入数据，可以在开始前删除 input/ 目录。
下载输入数据是问题的常见原因。维护
执行此操作的代码部分（与
核心 GISTEMP 算法无关）是一项巨大的成本。如果
我们提供的工具似乎无法正确下载输入数据，您可以
“手动”下载数据并将其安装在 input/ 目录中。有关详细信息，请参阅
doc/input.txt。
5. 运行
要运行 ccc-gistemp：
python tool/run.py
该命令运行步骤 0 到 5。要仅运行单个步骤或更短
的步骤序列，请使用 -s 参数。例如：
python tool/run.py -s 3 # 只运行第 3 步
python tool/run.py -s 0-3,5 # 运行步骤 0,1,2,3,5（省略 4）
我们使用这个目录结构：
ccc-gistemp-xxx/code/ 仅适用于 GISTEMP 算法的源代码
/config/ 配置文件
/doc/ 内部开发人员文档
/input/ 输入数据文件
/log/ 日志文件
/tool/ 工具 - GISTEMP 算法以外的源
/work/ 中间数据文件
/result/ 最终结果文件
运行代码应编写获取
输入数据时写入 input/ 目录，但随后只写入 work/ log/ 和 result/
目录。在运行 tool/run.py 之前，这些目录都可以被
删除（如果你希望，例如，有一个干净的运行）。
2011 年，在 Amazon EC2“高 CPU 中型实例”上完整运行大约需要 35 分钟，
这比开发人员使用的那种不太令人印象深刻的
机器要快一些。如果您希望它
运行得更快，我们建议您使用 PyPy（
Python http://codespeak.net/pypy/dist/pypy/doc/ 的替代实现）运行。请参阅 Paul Ollis 的此注释
：
http ://groups.google.com/group/ccc-gistemp-discuss/browse_thread/thread/cb0409e770820680
6. 结果
运行 run.py 后，GISTEMP 结果文件都在结果/
目录。使用 Google Chart
API 制作一个简单的图形图表；此文件：
result/google-chart.url
包含显示全球年平均地表
温度异常的图表的 URL。如果您在两个不同的目录 old-result/ 和 new-result/
中有两次单独运行的结果，则可以使用以下命令生成比较两者的 HTML 报告： python tool/compare_results.py --labela=old - -labela=new old-result new-result这将在当前目录下生成一个名为 index.html 的文件，包括两个结果文件的各种统计比较。7. 回归测试要针对 GISTEMP 测试 ccc-gistemp： python tool/regression.py
这将从
http://ccc-gistemp.googlecode.com/files/ccc-gistemp-test-2009-12-28.tar.gz获取压缩包
并将其解压缩到本地目录 ccc-gistemp-test-2009- 12-28/。这包含由 NASA GISS 的 Reto Ruedy 博士从2009 年 12 月 28 日在 GISS 的 GISTEMP实际运行中
友好地提供给 ccc-gistemp 项目的输入文件和结果数据。提取并解压 tarball 后，将在其上运行本地 ccc-gistemp 代码并比较结果，在 index.html 中生成报告。请注意，参考运行的结果与 0.4.1（及后续版本）之间确实存在一些变化，主要是由于农村/城市站的 GISTEMP 算法的变化
自参考运行以来在 GISS 取得的区别。我们已经
在 ccc-gistemp 中复制了该更改（请参阅
http://ccc-gistemp.googlecode.com/issues/detail?id=54）。要测试
运行与参考 GISTEMP 运行相同算法的 ccc-gistemp ，请在运行 tool/regression.py 之前
编辑 code/parameters.py 以设置 use_global_brightness = False 。A. 参考文献无。B. 文档历史最近的更改首先：2010 年 10 月 29 日 DRJ 更新以准备 0.6.1。2010-10-22 DRJ 更新以准备 0.6.0。2010-07-21 DRJ 更新以准备 0.5.1。2010-07-19 DRJ 更新以准备 0.5.0。2010-07-13 DRJ 添加了关于 PyPy 的注释。2010-03-11 DRJ 更新以准备 0.4.1。
2010-03-09 DRJ 更新以准备 0.4.0。
2010-01-26 NB 更新以准备 0.3.0。
2010-01-25 DRJ 删除了 PNG 结果。
2010-01-22 注意更新以反映一些代码移动到工具/。
2010-01-11 NB 更新以更好地描述预检。
2010-01-06 DRJ 更新了我们的全 Python 状态。
2009-12-03 NB 更新以转移到 GoogleCode 项目。
2008-09-19 DRJ 添加了 PNG 结果。
2008-09-13 NB 更新为 CCC 0.1.0。
2008-09-12 NB 更新为 CCC 0.0.3。
2008-09-12 NB 更新为 CCC 0.0.2。
2008-09-11 NB 更新为 CCC 0.0.1。
2008-09-08 NB 创建。
C. 版权和许可
本文档版权所有 (C) 2009, 2010 Ravenbrook Limited；(C)
2010 年气候法规基金会。版权所有。
允许以任何形式重新分发和使用本文档，无论是否
修改，只要重新分发本
文档保留上述版权声明、本条件和
以下免责声明。
本文档由版权所有者和贡献者“按
原样”提供，不提供任何明示或暗示的保证，包括但不限于
对适销性和
特定用途适用性的暗示保证。在任何情况下，版权所有
者和贡献者均不对任何直接、间接、偶然、
特殊、惩戒性或后果性损害（包括但不限于
采购替代商品或服务；使用、数据或
利润的损失；或业务中断），无论是由何种责任理论
引起的，无论是在合同、严格责任或侵权行为（包括
疏忽或其他方式）中以任何方式因使用本
文档而引起的，即使已被告知存在此类损害的可能性。
$URL: https://ccc-gistemp.googlecode.com/svn/branches/2011-05-18/gsoc/readme.txt $
$Rev: 772 $
Nick Barnes，气候代码基金会
David Jones，气候代码基金会
$日期：2011-06-01 16:08:26 -0400（2011 年 6 月 1 日，星期三） $
内容
1. 简介
2 . 依赖关系
3. 安装
4. 输入数据
5. 运行
6. 结果
7. 回归测试
A. 参考文献
B. 文档历史
C. 版权和许可
1. 简介
这是 Clear Climate Code GISTEMP 项目
(ccc-吉斯普）。
Clear Climate Code 重新实施了 GISTEMP（GISS 表面
温度分析系统），使其更加清晰。工作继续
使其更清晰和更易于访问。
ccc-gistemp 0.6.1 版是 ccc-gistemp 0.6 版的发布。
0.6 版的目的是通过以下方式使 ccc-gistemp 更有用：
- 允许更灵活地选择输入数据。例如：GHCN v3；
仅限 USHCN；仅限海洋。
- 允许在陆地和海洋
数据相结合的步骤中使用陆地掩膜。
- 在 NumPy 数组上使用。
- 添加 setup.py
此外，还有各种错误修复和清晰度改进。release-notes.txt
中更详细地描述了自早期版本以来的更改。更多信息的 URL： http: //clearclimatecode.org/ Clear Climate Code 网站和博客。
http://ccc-gistemp.googlecode.com/ ccc-gistemp 代码库。
2. 依赖项
你需要 Python 和可以运行它的机器，以及网络
连接；没有明确的操作系统或 CPU 架构
依赖性，因此“任何”操作系统或 CPU 都应该没问题。
Python 有几个版本。我们推荐使用 Python 2.6 或 Python
2.7，但 ccc-gistemp 应该适用于
2.x 分支（自 2.4 起）的任何 Python 版本。它不适用于 Python 3.x（
python.org 称之为“闪亮的新事物”）。对 Python 2.4（以及
在某种程度上 2.5）的支持仍然很脆弱，并且
在过去引起了一些问题。
代码应该在 OS X、FreeBSD、Windows 和可能的各种
其他类 Unix 操作系统。
需要网络连接才能下载输入文件（
只需完成一次），并从
结果中显示可选图形。如果您使用代理访问 Internet，则 Python 要求
设置“http_proxy”环境变量。代理需要
同时处理 HTTP 和 FTP 请求（这似乎会引起一些麻烦，
请参阅下面的“输入数据”以手动下载数据）。
Python 可能已经安装在你的机器上（例如，它
预装在 OS X 上），你可以使用
操作系统的包管理器来安装它；对于 Windows，您可以
从 http://www.python.org/download/ 下载安装程序。我们建议您使用
Python 2.x 系列的稳定生产版本（Python 3.x 将
不起作用）。
3. 安装
解压 ccc-gistemp-0.6.1.tar.gz。
4. INPUT DATA
ccc-gistemp 使用子目录 input/ 中的输入数据。该输入数据包括来自 GHCN、USHCN 和海面数据的温度记录的
大文件（几兆字节到几十兆字节），以及来自 GISS的附加温度记录和台站表的小文件。ccc-gistemp 包含代码 (tool/preflight.py) ，用于通过Internet从发起组织获取此数据。如果文件已经存在于 input/ 目录中，它将不会下载文件，因此如果您希望运行 ccc-gistemp 并更新
输入数据，可以在开始前删除 input/ 目录。
下载输入数据是问题的常见原因。维护
执行此操作的代码部分（与
核心 GISTEMP 算法无关）是一项巨大的成本。如果
我们提供的工具似乎无法正确下载输入数据，您可以
“手动”下载数据并将其安装在 input/ 目录中。有关详细信息，请参阅
doc/input.txt。
5. 运行
要运行 ccc-gistemp：
python tool/run.py
该命令运行步骤 0 到 5。要仅运行单个步骤或更短
的步骤序列，请使用 -s 参数。例如：
python tool/run.py -s 3 # 只运行第 3 步
python tool/run.py -s 0-3,5 # 运行步骤 0,1,2,3,5（省略 4）
我们使用这个目录结构：
ccc-gistemp-xxx/code/ 仅适用于 GISTEMP 算法的源代码
/config/ 配置文件
/doc/ 内部开发人员文档
/input/ 输入数据文件
/log/ 日志文件
/tool/ 工具 - GISTEMP 算法以外的源
/work/ 中间数据文件
/result/ 最终结果文件
运行代码应编写获取
输入数据时写入 input/ 目录，但随后只写入 work/ log/ 和 result/
目录。在运行 tool/run.py 之前，这些目录都可以被
删除（如果你希望，例如，有一个干净的运行）。
2011 年，在 Amazon EC2“高 CPU 中型实例”上完整运行大约需要 35 分钟，
这比开发人员使用的那种不太令人印象深刻的
机器要快一些。如果您希望它
运行得更快，我们建议您使用 PyPy（
Python http://codespeak.net/pypy/dist/pypy/doc/ 的替代实现）运行。请参阅 Paul Ollis 的此注释
：
http ://groups.google.com/group/ccc-gistemp-discuss/browse_thread/thread/cb0409e770820680
6. 结果
运行 run.py 后，GISTEMP 结果文件都在结果/
目录。使用 Google Chart
API 制作一个简单的图形图表；此文件：
result/google-chart.url
包含显示全球年平均地表
温度异常的图表的 URL。如果您在两个不同的目录 old-result/ 和 new-result/
中有两次单独运行的结果，则可以使用以下命令生成比较两者的 HTML 报告： python tool/compare_results.py --labela=old - -labela=new old-result new-result这将在当前目录下生成一个名为 index.html 的文件，包括两个结果文件的各种统计比较。7. 回归测试要针对 GISTEMP 测试 ccc-gistemp： python tool/regression.py
这将从
http://ccc-gistemp.googlecode.com/files/ccc-gistemp-test-2009-12-28.tar.gz获取压缩包
并将其解压缩到本地目录 ccc-gistemp-test-2009- 12-28/。这包含由 NASA GISS 的 Reto Ruedy 博士从2009 年 12 月 28 日在 GISS 的 GISTEMP实际运行中
友好地提供给 ccc-gistemp 项目的输入文件和结果数据。提取并解压 tarball 后，将在其上运行本地 ccc-gistemp 代码并比较结果，在 index.html 中生成报告。请注意，参考运行的结果与 0.4.1（及后续版本）之间确实存在一些变化，主要是由于农村/城市站的 GISTEMP 算法的变化
自参考运行以来在 GISS 取得的区别。我们已经
在 ccc-gistemp 中复制了该更改（请参阅
http://ccc-gistemp.googlecode.com/issues/detail?id=54）。要测试
运行与参考 GISTEMP 运行相同算法的 ccc-gistemp ，请在运行 tool/regression.py 之前
编辑 code/parameters.py 以设置 use_global_brightness = False 。A. 参考文献无。B. 文档历史最近的更改首先：2010 年 10 月 29 日 DRJ 更新以准备 0.6.1。2010-10-22 DRJ 更新以准备 0.6.0。2010-07-21 DRJ 更新以准备 0.5.1。2010-07-19 DRJ 更新以准备 0.5.0。2010-07-13 DRJ 添加了关于 PyPy 的注释。2010-03-11 DRJ 更新以准备 0.4.1。
2010-03-09 DRJ 更新以准备 0.4.0。
2010-01-26 NB 更新以准备 0.3.0。
2010-01-25 DRJ 删除了 PNG 结果。
2010-01-22 注意更新以反映一些代码移动到工具/。
2010-01-11 NB 更新以更好地描述预检。
2010-01-06 DRJ 更新了我们的全 Python 状态。
2009-12-03 NB 更新以转移到 GoogleCode 项目。
2008-09-19 DRJ 添加了 PNG 结果。
2008-09-13 NB 更新为 CCC 0.1.0。
2008-09-12 NB 更新为 CCC 0.0.3。
2008-09-12 NB 更新为 CCC 0.0.2。
2008-09-11 NB 更新为 CCC 0.0.1。
2008-09-08 NB 创建。
C. 版权和许可
本文档版权所有 (C) 2009, 2010 Ravenbrook Limited；(C)
2010 年气候法规基金会。版权所有。
允许以任何形式重新分发和使用本文档，无论是否
修改，只要重新分发本
文档保留上述版权声明、本条件和
以下免责声明。
本文档由版权所有者和贡献者“按
原样”提供，不提供任何明示或暗示的保证，包括但不限于
对适销性和
特定用途适用性的暗示保证。在任何情况下，版权所有
者和贡献者均不对任何直接、间接、偶然、
特殊、惩戒性或后果性损害（包括但不限于
采购替代商品或服务；使用、数据或
利润的损失；或业务中断），无论是由何种责任理论
引起的，无论是在合同、严格责任或侵权行为（包括
疏忽或其他方式）中以任何方式因使用本
文档而引起的，即使已被告知存在此类损害的可能性。
$URL: https://ccc-gistemp.googlecode.com/svn/branches/2011-05-18/gsoc/readme.txt $
$Rev: 772 $
