查看可用数据集¶
data_list() 列出所有可下载的数据集，并标注本地是否已缓存。
In [1]:
Copied!
from multicolor import data_list
for ds in data_list():
status = '[cached]' if ds['available'] else '[not downloaded]'
print(f"{ds['name']:20s} {ds['type']:8s} {ds['format']:6s} {ds['size_hint']:>8s} {status}")
from multicolor import data_list
for ds in data_list():
status = '[cached]' if ds['available'] else '[not downloaded]'
print(f"{ds['name']:20s} {ds['type']:8s} {ds['format']:6s} {ds['size_hint']:>8s} {status}")
tavg_10min raster tif 3.2 MB [not downloaded] tmax_10min raster tif 3.2 MB [not downloaded] tmin_10min raster tif 3.3 MB [not downloaded]
In [2]:
Copied!
from multicolor import data_ensure
# 首次调用会自动下载
path = data_ensure('tavg_10min')
print(f'Local path: {path}')
print(f'File exists: {path.exists()}')
# 再次调用直接返回缓存路径
path2 = data_ensure('tavg_10min')
print(f'Same path: {path == path2}')
from multicolor import data_ensure
# 首次调用会自动下载
path = data_ensure('tavg_10min')
print(f'Local path: {path}')
print(f'File exists: {path.exists()}')
# 再次调用直接返回缓存路径
path2 = data_ensure('tavg_10min')
print(f'Same path: {path == path2}')
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 1%
Downloading... 1%
Downloading... 1%
Downloading... 1%
Downloading... 2%
Downloading... 2%
Downloading... 2%
Downloading... 2%
Downloading... 3%
Downloading... 3%
Downloading... 3%
Downloading... 3%
Downloading... 4%
Downloading... 4%
Downloading... 4%
Downloading... 4%
Downloading... 5%
Downloading... 5%
Downloading... 5%
Downloading... 5%
Downloading... 6%
Downloading... 6%
Downloading... 6%
Downloading... 6%
Downloading... 7%
Downloading... 7%
Downloading... 7%
Downloading... 7%
Downloading... 8%
Downloading... 8%
Downloading... 8%
Downloading... 8%
Downloading... 9%
Downloading... 9%
Downloading... 9%
Downloading... 9%
Downloading... 10%
Downloading... 10%
Downloading... 10%
Downloading... 10%
Downloading... 11%
Downloading... 11%
Downloading... 11%
Downloading... 11%
Downloading... 12%
Downloading... 12%
Downloading... 12%
Downloading... 12%
Downloading... 13%
Downloading... 13%
Downloading... 13%
Downloading... 13%
Downloading... 14%
Downloading... 14%
Downloading... 14%
Downloading... 14%
Downloading... 15%
Downloading... 15%
Downloading... 15%
Downloading... 15%
Downloading... 15%
Downloading... 16%
Downloading... 16%
Downloading... 16%
Downloading... 16%
Downloading... 17%
Downloading... 17%
Downloading... 17%
Downloading... 17%
Downloading... 18%
Downloading... 18%
Downloading... 18%
Downloading... 18%
Downloading... 19%
Downloading... 19%
Downloading... 19%
Downloading... 19%
Downloading... 20%
Downloading... 20%
Downloading... 20%
Downloading... 20%
Downloading... 21%
Downloading... 21%
Downloading... 21%
Downloading... 21%
Downloading... 22%
Downloading... 22%
Downloading... 22%
Downloading... 22%
Downloading... 23%
Downloading... 23%
Downloading... 23%
Downloading... 23%
Downloading... 24%
Downloading... 24%
Downloading... 24%
Downloading... 24%
Downloading... 25%
Downloading... 25%
Downloading... 25%
Downloading... 25%
Downloading... 26%
Downloading... 26%
Downloading... 26%
Downloading... 26%
Downloading... 27%
Downloading... 27%
Downloading... 27%
Downloading... 27%
Downloading... 28%
Downloading... 28%
Downloading... 28%
Downloading... 28%
Downloading... 29%
Downloading... 29%
Downloading... 29%
Downloading... 29%
Downloading... 30%
Downloading... 30%
Downloading... 30%
Downloading... 30%
Downloading... 30%
Downloading... 31%
Downloading... 31%
Downloading... 31%
Downloading... 31%
Downloading... 32%
Downloading... 32%
Downloading... 32%
Downloading... 32%
Downloading... 33%
Downloading... 33%
Downloading... 33%
Downloading... 33%
Downloading... 34%
Downloading... 34%
Downloading... 34%
Downloading... 34%
Downloading... 35%
Downloading... 35%
Downloading... 35%
Downloading... 35%
Downloading... 36%
Downloading... 36%
Downloading... 36%
Downloading... 36%
Downloading... 37%
Downloading... 37%
Downloading... 37%
Downloading... 37%
Downloading... 38%
Downloading... 38%
Downloading... 38%
Downloading... 38%
Downloading... 39%
Downloading... 39%
Downloading... 39%
Downloading... 39%
Downloading... 40%
Downloading... 40%
Downloading... 40%
Downloading... 40%
Downloading... 41%
Downloading... 41%
Downloading... 41%
Downloading... 41%
Downloading... 42%
Downloading... 42%
Downloading... 42%
Downloading... 42%
Downloading... 43%
Downloading... 43%
Downloading... 43%
Downloading... 43%
Downloading... 44%
Downloading... 44%
Downloading... 44%
Downloading... 44%
Downloading... 45%
Downloading... 45%
Downloading... 45%
Downloading... 45%
Downloading... 45%
Downloading... 46%
Downloading... 46%
Downloading... 46%
Downloading... 46%
Downloading... 47%
Downloading... 47%
Downloading... 47%
Downloading... 47%
Downloading... 48%
Downloading... 48%
Downloading... 48%
Downloading... 48%
Downloading... 49%
Downloading... 49%
Downloading... 49%
Downloading... 49%
Downloading... 50%
Downloading... 50%
Downloading... 50%
Downloading... 50%
Downloading... 51%
Downloading... 51%
Downloading... 51%
Downloading... 51%
Downloading... 52%
Downloading... 52%
Downloading... 52%
Downloading... 52%
Downloading... 53%
Downloading... 53%
Downloading... 53%
Downloading... 53%
Downloading... 54%
Downloading... 54%
Downloading... 54%
Downloading... 54%
Downloading... 55%
Downloading... 55%
Downloading... 55%
Downloading... 55%
Downloading... 56%
Downloading... 56%
Downloading... 56%
Downloading... 56%
Downloading... 57%
Downloading... 57%
Downloading... 57%
Downloading... 57%
Downloading... 58%
Downloading... 58%
Downloading... 58%
Downloading... 58%
Downloading... 59%
Downloading... 59%
Downloading... 59%
Downloading... 59%
Downloading... 60%
Downloading... 60%
Downloading... 60%
Downloading... 60%
Downloading... 60%
Downloading... 61%
Downloading... 61%
Downloading... 61%
Downloading... 61%
Downloading... 62%
Downloading... 62%
Downloading... 62%
Downloading... 62%
Downloading... 63%
Downloading... 63%
Downloading... 63%
Downloading... 63%
Downloading... 64%
Downloading... 64%
Downloading... 64%
Downloading... 64%
Downloading... 65%
Downloading... 65%
Downloading... 65%
Downloading... 65%
Downloading... 66%
Downloading... 66%
Downloading... 66%
Downloading... 66%
Downloading... 67%
Downloading... 67%
Downloading... 67%
Downloading... 67%
Downloading... 68%
Downloading... 68%
Downloading... 68%
Downloading... 68%
Downloading... 69%
Downloading... 69%
Downloading... 69%
Downloading... 69%
Downloading... 70%
Downloading... 70%
Downloading... 70%
Downloading... 70%
Downloading... 71%
Downloading... 71%
Downloading... 71%
Downloading... 71%
Downloading... 72%
Downloading... 72%
Downloading... 72%
Downloading... 72%
Downloading... 73%
Downloading... 73%
Downloading... 73%
Downloading... 73%
Downloading... 74%
Downloading... 74%
Downloading... 74%
Downloading... 74%
Downloading... 75%
Downloading... 75%
Downloading... 75%
Downloading... 75%
Downloading... 75%
Downloading... 76%
Downloading... 76%
Downloading... 76%
Downloading... 76%
Downloading... 77%
Downloading... 77%
Downloading... 77%
Downloading... 77%
Downloading... 78%
Downloading... 78%
Downloading... 78%
Downloading... 78%
Downloading... 79%
Downloading... 79%
Downloading... 79%
Downloading... 79%
Downloading... 80%
Downloading... 80%
Downloading... 80%
Downloading... 80%
Downloading... 81%
Downloading... 81%
Downloading... 81%
Downloading... 81%
Downloading... 82%
Downloading... 82%
Downloading... 82%
Downloading... 82%
Downloading... 83%
Downloading... 83%
Downloading... 83%
Downloading... 83%
Downloading... 84%
Downloading... 84%
Downloading... 84%
Downloading... 84%
Downloading... 85%
Downloading... 85%
Downloading... 85%
Downloading... 85%
Downloading... 86%
Downloading... 86%
Downloading... 86%
Downloading... 86%
Downloading... 87%
Downloading... 87%
Downloading... 87%
Downloading... 87%
Downloading... 88%
Downloading... 88%
Downloading... 88%
Downloading... 88%
Downloading... 89%
Downloading... 89%
Downloading... 89%
Downloading... 89%
Downloading... 90%
Downloading... 90%
Downloading... 90%
Downloading... 90%
Downloading... 90%
Downloading... 91%
Downloading... 91%
Downloading... 91%
Downloading... 91%
Downloading... 92%
Downloading... 92%
Downloading... 92%
Downloading... 92%
Downloading... 93%
Downloading... 93%
Downloading... 93%
Downloading... 93%
Downloading... 94%
Downloading... 94%
Downloading... 94%
Downloading... 94%
Downloading... 95%
Downloading... 95%
Downloading... 95%
Downloading... 95%
Downloading... 96%
Downloading... 96%
Downloading... 96%
Downloading... 96%
Downloading... 97%
Downloading... 97%
Downloading... 97%
Downloading... 97%
Downloading... 98%
Downloading... 98%
Downloading... 98%
Downloading... 98%
Downloading... 99%
Downloading... 99%
Downloading... 99%
Downloading... 99%
Downloading... 100%
Local path: /home/runner/.multicolor/data/tavg_10min.tif File exists: True
Same path: True
In [3]:
Copied!
from multicolor import data_ensure
import matplotlib.pyplot as plt
tavg_path = data_ensure('tavg_10min')
try:
import rasterio
with rasterio.open(tavg_path) as src:
data = src.read(1)
extent = [src.bounds.left, src.bounds.right, src.bounds.bottom, src.bounds.top]
print(f'Shape: {data.shape}')
print(f'CRS: {src.crs}')
print(f'Bounds: {src.bounds}')
plt.figure(figsize=(10, 5))
plt.imshow(data, cmap='YlOrRd', extent=extent)
plt.title(f'Temperature (from {tavg_path.name})')
plt.colorbar(label='Value')
plt.xlabel('Longitude')
plt.ylabel('Latitude')
plt.tight_layout()
plt.show()
except ImportError:
print('rasterio not installed. Install with: pip install rasterio')
print(f'File path: {tavg_path}')
from multicolor import data_ensure
import matplotlib.pyplot as plt
tavg_path = data_ensure('tavg_10min')
try:
import rasterio
with rasterio.open(tavg_path) as src:
data = src.read(1)
extent = [src.bounds.left, src.bounds.right, src.bounds.bottom, src.bounds.top]
print(f'Shape: {data.shape}')
print(f'CRS: {src.crs}')
print(f'Bounds: {src.bounds}')
plt.figure(figsize=(10, 5))
plt.imshow(data, cmap='YlOrRd', extent=extent)
plt.title(f'Temperature (from {tavg_path.name})')
plt.colorbar(label='Value')
plt.xlabel('Longitude')
plt.ylabel('Latitude')
plt.tight_layout()
plt.show()
except ImportError:
print('rasterio not installed. Install with: pip install rasterio')
print(f'File path: {tavg_path}')
rasterio not installed. Install with: pip install rasterio File path: /home/runner/.multicolor/data/tavg_10min.tif
强制重新下载¶
如果需要更新数据，使用 data_get(name, force=True) 重新下载。
In [4]:
Copied!
from multicolor import data_get
# 强制重新下载（会覆盖本地缓存）
# path = data_get('tavg_10min', force=True)
from multicolor import data_get
# 强制重新下载（会覆盖本地缓存）
# path = data_get('tavg_10min', force=True)
删除缓存¶
data_remove() 删除已缓存的数据文件，释放磁盘空间。
In [5]:
Copied!
from multicolor import data_ensure, data_remove, is_available
# 下载
data_ensure('tmin_10min')
print('After download:', is_available('tmin_10min'))
# 删除缓存
data_remove('tmin_10min')
print('After remove:', is_available('tmin_10min'))
from multicolor import data_ensure, data_remove, is_available
# 下载
data_ensure('tmin_10min')
print('After download:', is_available('tmin_10min'))
# 删除缓存
data_remove('tmin_10min')
print('After remove:', is_available('tmin_10min'))
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 0%
Downloading... 1%
Downloading... 1%
Downloading... 1%
Downloading... 1%
Downloading... 2%
Downloading... 2%
Downloading... 2%
Downloading... 2%
Downloading... 3%
Downloading... 3%
Downloading... 3%
Downloading... 3%
Downloading... 4%
Downloading... 4%
Downloading... 4%
Downloading... 4%
Downloading... 5%
Downloading... 5%
Downloading... 5%
Downloading... 5%
Downloading... 6%
Downloading... 6%
Downloading... 6%
Downloading... 6%
Downloading... 7%
Downloading... 7%
Downloading... 7%
Downloading... 7%
Downloading... 8%
Downloading... 8%
Downloading... 8%
Downloading... 8%
Downloading... 9%
Downloading... 9%
Downloading... 9%
Downloading... 9%
Downloading... 9%
Downloading... 10%
Downloading... 10%
Downloading... 10%
Downloading... 10%
Downloading... 11%
Downloading... 11%
Downloading... 11%
Downloading... 11%
Downloading... 12%
Downloading... 12%
Downloading... 12%
Downloading... 12%
Downloading... 13%
Downloading... 13%
Downloading... 13%
Downloading... 13%
Downloading... 14%
Downloading... 14%
Downloading... 14%
Downloading... 14%
Downloading... 15%
Downloading... 15%
Downloading... 15%
Downloading... 15%
Downloading... 16%
Downloading... 16%
Downloading... 16%
Downloading... 16%
Downloading... 17%
Downloading... 17%
Downloading... 17%
Downloading... 17%
Downloading... 18%
Downloading... 18%
Downloading... 18%
Downloading... 18%
Downloading... 18%
Downloading... 19%
Downloading... 19%
Downloading... 19%
Downloading... 19%
Downloading... 20%
Downloading... 20%
Downloading... 20%
Downloading... 20%
Downloading... 21%
Downloading... 21%
Downloading... 21%
Downloading... 21%
Downloading... 22%
Downloading... 22%
Downloading... 22%
Downloading... 22%
Downloading... 23%
Downloading... 23%
Downloading... 23%
Downloading... 23%
Downloading... 24%
Downloading... 24%
Downloading... 24%
Downloading... 24%
Downloading... 25%
Downloading... 25%
Downloading... 25%
Downloading... 25%
Downloading... 26%
Downloading... 26%
Downloading... 26%
Downloading... 26%
Downloading... 27%
Downloading... 27%
Downloading... 27%
Downloading... 27%
Downloading... 27%
Downloading... 28%
Downloading... 28%
Downloading... 28%
Downloading... 28%
Downloading... 29%
Downloading... 29%
Downloading... 29%
Downloading... 29%
Downloading... 30%
Downloading... 30%
Downloading... 30%
Downloading... 30%
Downloading... 31%
Downloading... 31%
Downloading... 31%
Downloading... 31%
Downloading... 32%
Downloading... 32%
Downloading... 32%
Downloading... 32%
Downloading... 33%
Downloading... 33%
Downloading... 33%
Downloading... 33%
Downloading... 34%
Downloading... 34%
Downloading... 34%
Downloading... 34%
Downloading... 35%
Downloading... 35%
Downloading... 35%
Downloading... 35%
Downloading... 36%
Downloading... 36%
Downloading... 36%
Downloading... 36%
Downloading... 37%
Downloading... 37%
Downloading... 37%
Downloading... 37%
Downloading... 37%
Downloading... 38%
Downloading... 38%
Downloading... 38%
Downloading... 38%
Downloading... 39%
Downloading... 39%
Downloading... 39%
Downloading... 39%
Downloading... 40%
Downloading... 40%
Downloading... 40%
Downloading... 40%
Downloading... 41%
Downloading... 41%
Downloading... 41%
Downloading... 41%
Downloading... 42%
Downloading... 42%
Downloading... 42%
Downloading... 42%
Downloading... 43%
Downloading... 43%
Downloading... 43%
Downloading... 43%
Downloading... 44%
Downloading... 44%
Downloading... 44%
Downloading... 44%
Downloading... 45%
Downloading... 45%
Downloading... 45%
Downloading... 45%
Downloading... 46%
Downloading... 46%
Downloading... 46%
Downloading... 46%
Downloading... 46%
Downloading... 47%
Downloading... 47%
Downloading... 47%
Downloading... 47%
Downloading... 48%
Downloading... 48%
Downloading... 48%
Downloading... 48%
Downloading... 49%
Downloading... 49%
Downloading... 49%
Downloading... 49%
Downloading... 50%
Downloading... 50%
Downloading... 50%
Downloading... 50%
Downloading... 51%
Downloading... 51%
Downloading... 51%
Downloading... 51%
Downloading... 52%
Downloading... 52%
Downloading... 52%
Downloading... 52%
Downloading... 53%
Downloading... 53%
Downloading... 53%
Downloading... 53%
Downloading... 54%
Downloading... 54%
Downloading... 54%
Downloading... 54%
Downloading... 55%
Downloading... 55%
Downloading... 55%
Downloading... 55%
Downloading... 55%
Downloading... 56%
Downloading... 56%
Downloading... 56%
Downloading... 56%
Downloading... 57%
Downloading... 57%
Downloading... 57%
Downloading... 57%
Downloading... 58%
Downloading... 58%
Downloading... 58%
Downloading... 58%
Downloading... 59%
Downloading... 59%
Downloading... 59%
Downloading... 59%
Downloading... 60%
Downloading... 60%
Downloading... 60%
Downloading... 60%
Downloading... 61%
Downloading... 61%
Downloading... 61%
Downloading... 61%
Downloading... 62%
Downloading... 62%
Downloading... 62%
Downloading... 62%
Downloading... 63%
Downloading... 63%
Downloading... 63%
Downloading... 63%
Downloading... 64%
Downloading... 64%
Downloading... 64%
Downloading... 64%
Downloading... 65%
Downloading... 65%
Downloading... 65%
Downloading... 65%
Downloading... 65%
Downloading... 66%
Downloading... 66%
Downloading... 66%
Downloading... 66%
Downloading... 67%
Downloading... 67%
Downloading... 67%
Downloading... 67%
Downloading... 68%
Downloading... 68%
Downloading... 68%
Downloading... 68%
Downloading... 69%
Downloading... 69%
Downloading... 69%
Downloading... 69%
Downloading... 70%
Downloading... 70%
Downloading... 70%
Downloading... 70%
Downloading... 71%
Downloading... 71%
Downloading... 71%
Downloading... 71%
Downloading... 72%
Downloading... 72%
Downloading... 72%
Downloading... 72%
Downloading... 73%
Downloading... 73%
Downloading... 73%
Downloading... 73%
Downloading... 74%
Downloading... 74%
Downloading... 74%
Downloading... 74%
Downloading... 74%
Downloading... 75%
Downloading... 75%
Downloading... 75%
Downloading... 75%
Downloading... 76%
Downloading... 76%
Downloading... 76%
Downloading... 76%
Downloading... 77%
Downloading... 77%
Downloading... 77%
Downloading... 77%
Downloading... 78%
Downloading... 78%
Downloading... 78%
Downloading... 78%
Downloading... 79%
Downloading... 79%
Downloading... 79%
Downloading... 79%
Downloading... 80%
Downloading... 80%
Downloading... 80%
Downloading... 80%
Downloading... 81%
Downloading... 81%
Downloading... 81%
Downloading... 81%
Downloading... 82%
Downloading... 82%
Downloading... 82%
Downloading... 82%
Downloading... 83%
Downloading... 83%
Downloading... 83%
Downloading... 83%
Downloading... 83%
Downloading... 84%
Downloading... 84%
Downloading... 84%
Downloading... 84%
Downloading... 85%
Downloading... 85%
Downloading... 85%
Downloading... 85%
Downloading... 86%
Downloading... 86%
Downloading... 86%
Downloading... 86%
Downloading... 87%
Downloading... 87%
Downloading... 87%
Downloading... 87%
Downloading... 88%
Downloading... 88%
Downloading... 88%
Downloading... 88%
Downloading... 89%
Downloading... 89%
Downloading... 89%
Downloading... 89%
Downloading... 90%
Downloading... 90%
Downloading... 90%
Downloading... 90%
Downloading... 91%
Downloading... 91%
Downloading... 91%
Downloading... 91%
Downloading... 92%
Downloading... 92%
Downloading... 92%
Downloading... 92%
Downloading... 92%
Downloading... 93%
Downloading... 93%
Downloading... 93%
Downloading... 93%
Downloading... 94%
Downloading... 94%
Downloading... 94%
Downloading... 94%
Downloading... 95%
Downloading... 95%
Downloading... 95%
Downloading... 95%
Downloading... 96%
Downloading... 96%
Downloading... 96%
Downloading... 96%
Downloading... 97%
Downloading... 97%
Downloading... 97%
Downloading... 97%
Downloading... 98%
Downloading... 98%
Downloading... 98%
Downloading... 98%
Downloading... 99%
Downloading... 99%
Downloading... 99%
Downloading... 99%
Downloading... 100%
After download: True
After remove: False