手动下载era5数据era5_manual_download
<p>[TOC]</p>
<p>era5数据源属性列表详见:<a href="https://www.showdoc.com.cn/metdig/6060999066114040" title="era5数据源属性列表">era5数据源属性列表</a></p>
<h1>批量下载逐小时等压面数据</h1>
<p>逐小时等压面数据批量下载接口代码示例如下:</p>
<pre><code class="language-python">era5_psl_download_usepool(dt_start=None, dt_end=None, var_names=['hgt', 'u', 'v', 'vvel', 'rh', 'tmp', 'pv', 'div','spfh','vort'],
pressure_level=[200,225,250,300,350,400,450,500,550,600,650,700,
750,775,800,825,850,875,900,925,950,975,1000],
hour=np.arange(0,24,1).tolist(),
extent=[50, 160, 0, 70], download_dir=None, max_pool=2, is_overwrite=True)</code></pre>
<p><em>注:参数均为北京时,下载时按照世界时下载,然后按照世界时自动拆分到cache目录下</em></p>
<p><font size="4"><b>参数说明</b></font></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">默认</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">dt_start</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">开始时间</td>
</tr>
<tr>
<td style="text-align: left;">dt_end</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结束时间</td>
</tr>
<tr>
<td style="text-align: left;">var_names</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['hgt', 'u', 'v', 'vvel', 'rh', 'tmp', 'pv', 'div','spfh','vort']</td>
<td style="text-align: left;">数据要素名</td>
</tr>
<tr>
<td style="text-align: left;">pressure_level</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['200', '225', '250', '300', '350', '400', '450', '500', '550', '600', '650', '700',<br/>'750', '775', '800', '825', '850', '875', '900', '925', '950', '975', '1000']</td>
<td style="text-align: left;">层次</td>
</tr>
<tr>
<td style="text-align: left;">hour</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(0,24,1).tolist()</td>
<td style="text-align: left;">时次(北京时)</td>
</tr>
<tr>
<td style="text-align: left;">extent</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">[50, 160, 0, 70]</td>
<td style="text-align: left;">区域</td>
</tr>
<tr>
<td style="text-align: left;">download_dir</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">None</td>
<td style="text-align: left;">数据存放路径</td>
</tr>
<tr>
<td style="text-align: left;">max_pool</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">2</td>
<td style="text-align: left;">最大并行数</td>
</tr>
<tr>
<td style="text-align: left;">is_overwrite</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">True</td>
<td style="text-align: left;">是否重复下载,默认重复下载(该参数仅用于检查下载的数据,不检查拆分后的数据)</td>
</tr>
</tbody>
</table>
<p><font size="4"><b>调用示例</b></font></p>
<pre><code class="language-python">import datetime
from metdig.io.era5_manual_download import era5_psl_download_usepool
dt_start = datetime.datetime(2020, 1, 2) # 北京时
dt_end = datetime.datetime(2020, 1, 3)
hour = [2, 5, 8, 11, 14, 17, 20, 23]
era5_psl_download_usepool(dt_start, dt_end, var_names=['hgt', 'u', 'v'], hour=hour)</code></pre>
<p><font size="4"><b>输出文件</b></font></p>
<pre><code class="language-python">例如:
~\.metdig\cache\ERA5_DATA\202001010000\hourly\hgt\200\202001010100_50_160_0_70.nc
~\.metdig\cache\ERA5_DATA\202001010000\hourly\hgt\500\202001010100_50_160_0_70.nc
......</code></pre>
<h1>批量下载逐小时地面数据</h1>
<p>逐小时地面数据批量下载接口代码示例如下:</p>
<pre><code class="language-python">era5_sfc_download_usepool(dt_start=None, dt_end=None, var_names=['u10m','u100m', 'v10m','v100m', 'psfc', 'tcwv', 'prmsl','t2m','td2m','rain01','cape','cin','k_idx'],
hour=np.arange(0,24,1).tolist(),
extent=[50, 160, 0, 70], download_dir=None, max_pool=2, is_overwrite = True)</code></pre>
<p><em>注:参数均为北京时,下载时按照世界时下载,然后按照世界时自动拆分到cache目录下</em></p>
<p><font size="4"><b>参数说明</b></font></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">默认</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">dt_start</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">开始时间</td>
</tr>
<tr>
<td style="text-align: left;">dt_end</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">结束时间</td>
</tr>
<tr>
<td style="text-align: left;">var_names</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['u10m','u100m', 'v10m','v100m', 'psfc', 'tcwv', 'prmsl','t2m','td2m','rain01','cape','cin','k_idx']</td>
<td style="text-align: left;">数据要素名</td>
</tr>
<tr>
<td style="text-align: left;">hour</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(0,24,1).tolist()</td>
<td style="text-align: left;">时次(北京时)</td>
</tr>
<tr>
<td style="text-align: left;">extent</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">[50, 160, 0, 70]</td>
<td style="text-align: left;">区域</td>
</tr>
<tr>
<td style="text-align: left;">download_dir</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">None</td>
<td style="text-align: left;">数据存放路径</td>
</tr>
<tr>
<td style="text-align: left;">max_pool</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">2</td>
<td style="text-align: left;">最大并行数</td>
</tr>
<tr>
<td style="text-align: left;">is_overwrite</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">True</td>
<td style="text-align: left;">是否重复下载,默认重复下载(该参数仅用于检查下载的数据,不检查拆分后的数据)</td>
</tr>
</tbody>
</table>
<p><font size="4"><b>调用示例</b></font></p>
<pre><code class="language-python">import datetime
from metdig.io.era5_manual_download import era5_sfc_download_usepool
dt_start = datetime.datetime(2020, 1, 2) # 北京时
dt_end = datetime.datetime(2020, 1, 3)
hour = [2, 5, 8, 11, 14, 17, 20, 23]
era5_sfc_download_usepool(dt_start, dt_end, var_names=['u10m', 'v10m'], hour=hour)</code></pre>
<p><font size="4"><b>输出文件</b></font></p>
<pre><code class="language-python">~\.metdig\cache\ERA5_DATA\202001010100\hourly\u10m\202001010100_50_160_0_70.nc
~\.metdig\cache\ERA5_DATA\202001010100\hourly\v10m\202001010100_50_160_0_70.nc
......</code></pre>
<h1>逐小时等压面历史同期数据下载</h1>
<p>逐小时等压面历史同期数据批量下载接口代码示例如下:</p>
<pre><code class="language-python">era5_psl_sameperiod_download_usepool(years=np.arange(1980,2022).tolist(), month=7, day=10, beforeday=3, afterday=3,
var_names=['hgt', 'u', 'v', 'vvel', 'rh', 'tmp', 'pv', 'div','spfh','vort'],
pressure_level=[200,225,250,300,350,400,450,500,550,600,650,700,
750,775,800,825,850,875,900,925,950,975,1000],
hour=np.arange(0,24,1).tolist(),
extent=[50, 160, 0, 70], download_dir=None, max_pool=2, is_overwrite=True, is_return_data=False)</code></pre>
<p><em>注:参数均为北京时,下载时按照世界时下载,然后按照世界时自动拆分到cache目录下</em></p>
<p><font size="4"><b>参数说明</b></font></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">默认</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">years</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(1980,2022).tolist()</td>
<td style="text-align: left;">年份列表</td>
</tr>
<tr>
<td style="text-align: left;">month</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">7</td>
<td style="text-align: left;">月</td>
</tr>
<tr>
<td style="text-align: left;">day</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">10</td>
<td style="text-align: left;">日</td>
</tr>
<tr>
<td style="text-align: left;">beforeday</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">3</td>
<td style="text-align: left;">月日时间往前n天</td>
</tr>
<tr>
<td style="text-align: left;">afterday</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">3</td>
<td style="text-align: left;">月日时间往后n天</td>
</tr>
<tr>
<td style="text-align: left;">var_names</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['hgt', 'u', 'v', 'vvel', 'rh', 'tmp', 'pv', 'div','spfh','vort']</td>
<td style="text-align: left;">数据要素名</td>
</tr>
<tr>
<td style="text-align: left;">pressure_level</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['200', '225', '250', '300', '350', '400', '450', '500', '550', '600', '650', '700',<br/>'750', '775', '800', '825', '850', '875', '900', '925', '950', '975', '1000']</td>
<td style="text-align: left;">高空气压层</td>
</tr>
<tr>
<td style="text-align: left;">hour</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(0,24,1).tolist()</td>
<td style="text-align: left;">时次(北京时)</td>
</tr>
<tr>
<td style="text-align: left;">extent</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">[50, 160, 0, 70]</td>
<td style="text-align: left;">区域</td>
</tr>
<tr>
<td style="text-align: left;">download_dir</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">None</td>
<td style="text-align: left;">数据存放路径</td>
</tr>
<tr>
<td style="text-align: left;">max_pool</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">2</td>
<td style="text-align: left;">最大并行数</td>
</tr>
<tr>
<td style="text-align: left;">is_overwrite</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">True</td>
<td style="text-align: left;">是否重复下载,默认重复下载(该参数仅用于检查下载的数据,不检查拆分后的数据)</td>
</tr>
<tr>
<td style="text-align: left;">is_return_data</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">False</td>
<td style="text-align: left;">是否返回数据,默认不返回(True时范围字典,键为要素名,值为stda数据)</td>
</tr>
</tbody>
</table>
<p><font size="4"><b>调用示例</b></font></p>
<pre><code class="language-python">from metdig.io.era5_manual_download import era5_psl_sameperiod_download_usepool
era5_psl_sameperiod_download_usepool(years=np.arange(1980,2022), var_names=['u', 'v', 'tmp'], hour=[0,6,12,18], pressure_level=[500], beforeday=0, afterday=0)</code></pre>
<p><font size="4"><b>输出文件</b></font></p>
<pre><code class="language-python"></code></pre>
<h1>逐小时地面历史同期数据下载</h1>
<p>逐小时地面历史同期数据批量下载接口代码示例如下:</p>
<pre><code class="language-python">era5_sfc_sameperiod_download_usepool(years=np.arange(1980,2022).tolist(), month=7, day=10, beforeday=3, afterday=3,
var_names=['u10m','u100m', 'v10m','v100m', 'psfc', 'tcwv', 'prmsl','t2m','td2m','rain01','cape','cin','k_idx'],
hour=np.arange(0,24,1).tolist(),
extent=[50, 160, 0, 70], download_dir=None, max_pool=2, is_overwrite=True, is_return_data=True)</code></pre>
<p><em>注:参数均为北京时,下载时按照世界时下载,然后按照世界时自动拆分到cache目录下</em></p>
<p><font size="4"><b>参数说明</b></font></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">默认</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">years</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(1980,2022).tolist()</td>
<td style="text-align: left;">年份列表</td>
</tr>
<tr>
<td style="text-align: left;">month</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">7</td>
<td style="text-align: left;">月</td>
</tr>
<tr>
<td style="text-align: left;">day</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">10</td>
<td style="text-align: left;">日</td>
</tr>
<tr>
<td style="text-align: left;">beforeday</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">3</td>
<td style="text-align: left;">月日时间往前n天</td>
</tr>
<tr>
<td style="text-align: left;">afterday</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">3</td>
<td style="text-align: left;">月日时间往后n天</td>
</tr>
<tr>
<td style="text-align: left;">var_names</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">['u10m','u100m', 'v10m','v100m', 'psfc', 'tcwv', 'prmsl','t2m','td2m','rain01','cape','cin','k_idx']</td>
<td style="text-align: left;">数据要素名</td>
</tr>
<tr>
<td style="text-align: left;">hour</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">np.arange(0,24,1).tolist()</td>
<td style="text-align: left;">时次(北京时)</td>
</tr>
<tr>
<td style="text-align: left;">extent</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">[50, 160, 0, 70]</td>
<td style="text-align: left;">区域</td>
</tr>
<tr>
<td style="text-align: left;">download_dir</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">None</td>
<td style="text-align: left;">数据存放路径</td>
</tr>
<tr>
<td style="text-align: left;">max_pool</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">2</td>
<td style="text-align: left;">最大并行数</td>
</tr>
<tr>
<td style="text-align: left;">is_overwrite</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">True</td>
<td style="text-align: left;">是否重复下载,默认重复下载(该参数仅用于检查下载的数据,不检查拆分后的数据)</td>
</tr>
<tr>
<td style="text-align: left;">is_return_data</td>
<td style="text-align: left;"><font color="red">是</font></td>
<td style="text-align: left;">False</td>
<td style="text-align: left;">是否返回数据,默认不返回(True时范围字典,键为要素名,值为stda数据)</td>
</tr>
</tbody>
</table>
<p><font size="4"><b>调用示例</b></font></p>
<pre><code class="language-python">from metdig.io.era5_manual_download import era5_sfc_sameperiod_download_usepool
era5_sfc_sameperiod_download_usepool(years=np.arange(1980,2022), var_names=['u10m', 'v10m', 'prmsl'], hour=[0,6,12,18])</code></pre>
<p><font size="4"><b>输出文件</b></font></p>
<pre><code class="language-python"></code></pre>