metdig安装说明
<p>[TOC]</p>
<h1>MetDig 1.0.3以上版本在python3.9环境下已实现pip install metdig一键安装。</h1>
<h1>metdig老版本用户请注意:</h1>
<p>旧版CDS服务自2024年9月起将迁移至新版CDS并将停止旧版服务，需要用户自行更新账户信息，需要更新metdig或者cdsapi包<strong>（注意：2024年9月至12月使用过CDS-beta的用户也在2025年之后无法使用，请注意及时更新.cdsapirc文件中的url）</strong>。主要操作如下：</p>
<h2>整体逻辑为：</h2>
<p>登录cds旧账号->更新cdsapi或metdig->更新.cdsapirc文件->或使用metdig.io.config_init更新cds账户信息->更新使用条款</p>
<h3>步骤1：</h3>
<p>登录cds-beta官网，更新使用条款，获取新的token
cds-beta官网：<a href="https://cds.climate.copernicus.eu/">https://cds.climate.copernicus.eu/</a>
cds-beta用户token：<a href="https://cds.climate.copernicus.eu/profile">https://cds.climate.copernicus.eu/profile</a>
到最底部点击同意Terms of use <a href="https://cds.climate.copernicus.eu/datasets/reanalysis-era5-land?tab=download">https://cds.climate.copernicus.eu/datasets/reanalysis-era5-land?tab=download</a></p>
<h3>步骤2:</h3>
<p>如果不希望升级metdig，可使用以下命令pip show cdsapi 查看本地cdsapi版本，如果低于0.7.0，使用pip uninstall cdsapi命令卸载，使用pip install cdsapi>=0.7.0安装新版本</p>
<h3>步骤3：</h3>
<p>更新.cdsapirc文件为如下内容，key填用户token，$HOME/.cdsapirc (Linux)，C:/Users/USERNAME/.cdsapirc (windows)
url: <a href="https://cds.climate.copernicus.eu/api">https://cds.climate.copernicus.eu/api</a>
key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</p>
<h1>安装metdig</h1>
<h3>Step 1 安装Anaconda</h3>
<p>请自行下载安装Anaconda，<a href="https://www.anaconda.com/products/individual">https://www.anaconda.com/products/individual</a>
安装过程中推荐勾选将anaconda加入环境变量
并使用“管理员权限”打开Anaconda Prompt (Anaconda3) 对话框</p>
<h3>Step 2：创建新conda环境 metdig_app</h3>
<h6>如果cartopy不与其他python包冲突，用户可跳过此步骤，并且此步骤耗时会比较久</h6>
<p>创建新的conda环境。(如安装等待时间较长，可参考https://blog.csdn.net/qq_41719643/article/details/117877911 预先设置加速)
<code>conda create --name metdig_app python=3.9 --channel conda-forge</code>
<code>activate metdig_app</code></p>
<h3>Step3 pip install metdig</h3>
<h3>step4 配置metdig数据接口参数</h3>
<h3>metdig在线数据接口配置(注意，每个参数都是字符型)</h3>
<p>调用以下函数进行配置：</p>
<pre><code class="language-python">import metdig
#注意！每个参数均为字符型
metdig.io.config_init(CMADaaS_DNS=None, CMADaaS_PORT=None, CMADaaS_USER_ID=None, CMADaaS_PASSWORD=None, CMADaaS_serviceNodeId=None,
MICAPS_GDS_IP=None, MICAPS_GDS_PORT=None,
THREDDS_IP=None, THREDDS_PORT=None,
CDS_API_TOKEN=None,
CACHE_DIR=None,)</code></pre>
<p>配置时需将None改为对应的信息，如下所示：
<strong>CMADaaS数据源配置信息（因地区间可能有差异，需同气象信息中心确认CMADaaS_DNS、CMADaaS_PORT、CMADaaS_serviceNodeId）：</strong></p>
<ul>
<li>CMADaaS_DNS：xx.xx.xx.xx</li>
<li>CMADaaS_PORT：xx</li>
<li>CMADaaS_USER_ID：xxxxxxxxx</li>
<li>CMADaaS_PASSWORD：xxxxxxxxx</li>
<li>CMADaaS_serviceNodeId：NMIC_MUSIC_CMADAAS</li>
</ul>
<p><strong>MICAPS(Cassandra)数据源配置信息（注意，部分省市的脚本读取数据有限制ip，但不限制micaps4读取，需要联系运维人员开通）：</strong></p>
<ul>
<li>MICAPS_GDS_IP：xx.xx.xx.xx</li>
<li>MICAPS_GDS_PORT：xx</li>
</ul>
<p><strong>THREDDS数据源配置信息：</strong></p>
<ul>
<li>THREDDS_IP：xx.xx.xx.xx</li>
<li>THREDDS_PORT：xx</li>
</ul>
<p><strong>CDS（ERA5）数据源配置信息：</strong></p>
<ul>
<li>CDS_API_TOKEN：xxxxx
配置信息详见：<a href="https://cds-beta.climate.copernicus.eu/profile">https://cds-beta.climate.copernicus.eu/profile</a></li>
</ul>
<p><strong>数据缓存路径：</strong></p>
<ul>
<li>CACHE_DIR：~
若未设置，默认为如下路径（注意请确保斜杠方向正确）：
<ul>
<li>linux：/home/USERNAME/.metdig/cache</li>
<li>windows：C:/Users/USERNAME/.metdig/cache</li>
</ul></li>
</ul>
<h1>注意2：</h1>
<p>windows用户的 "C:/users/用户名" 用户名必须为英文，否则部分依赖包无法安装</p>
<h1>注意3：</h1>
<p>如若需应用天气识别相关功能，请配置java运行环境</p>
<h1>注意4：</h1>
<p>某些机器安装完成后回报错找不到‘gbk’字库
可在代码中设定全局变量为‘utf-8’字库，代码如下：
import os
os.environ['PYTHONIOENCODING']='utf-8'</p>
<h1>注意5：</h1>
<p>Linux系统安装metdig时有时会报错“unsupported locale setting”
在执行代码前执行以下代码即可
import locale
locale.setlocale(locale.LC_CTYPE, 'Chinese')</p>
<h1>安装Java环境</h1>
<p>请自行下载jre安装包，离线下载地址：<a href="https://www.java.com/zh-CN/download/">https://www.java.com/zh-CN/download/</a>
该安装包会自动把路径配好。</p>