ERDDAP > 文件 > 文档

ERDDAP的"files"系统允许您浏览虚拟文件系统并下载源数据文件。希望这是一个熟悉且简单的系统，您可以使用自己喜欢的 Web 浏览器或命令行程序（如curl ）使用它。

ERDDAP的设计理念是大多数数据集都非常庞大，因此大多数用户只需要或想要他们感兴趣的数据集的子集（例如，较小的地理区域、较小的时间范围或并非所有数据变量）。但我们知道有些用户实际上确实想要整个数据集，或者至少是源数据文件子集中的子集。如果您是这种情况，那么"files"系统可能适合您。 "files"系统的一个优点是您可以查看每个文件的大小（以字节为单位）和上次修改时间（ Zulu时区），因此很容易查看文件是否已更改。

点击

要使用"files"系统，只需单击。在任何"files"网页上，您可以：

单击标题（名称、上次修改、大小或说明）可按该属性对项目进行排序。反复单击一个标题可切换排序顺序（升序或降序）。请注意，“上次修改”使用Zulu时区。
单击目录名称即可转到该目录。
单击文件名即可下载该文件。

其他文件类型

默认情况下，目录列表以网页上的 HTML 表格形式返回。用户可以通过附加以下任意文件扩展名来请求以其他文件格式返回目录列表： .csv、 .htmlTable 、 .itx 、 .json 、 .jsonlCSV1 、 .jsonlCSV 、 .jsonlKVP 、 .mat 、 .nc 、 .nccsv 、 .tsv或.xhtml 。例如，以下网页并非如此：
https://coastwatch.pfeg.noaa.gov/erddap/files/jplMURSST41/
您可以请求以 .csv 文件形式提供目录列表：
https://coastwatch.pfeg.noaa.gov/erddap/files/jplMURSST41/.csv

警告！不同的元数据和变量名称

对于通过ERDDAP的tabledap或 griddap 提供的数据集， ERDDAP管理员可以设置ERDDAP以动态更改数据集的元数据和变量名称，以便您（用户）看到数据集元数据的改进版本。但在"files"中，您将看到原始元数据和变量名称，因此如果它们不同，请不要感到惊讶！如果您不习惯处理不同的元数据和变量名称，您可能更喜欢使用数据集的数据访问表单。

类似地，当您从ERDDAP的数据访问表单之一请求数据子集时，您可以指定想要接收的文件类型（例如.nc 、 .csv 、 .json 、 .mat ）。当然，通过"files"提供的源数据文件只有一种文件类型。如果您对源文件的文件类型不满意，您可能更喜欢使用数据集的数据访问表单。

并非所有数据集

此ERDDAP中的某些数据集无法通过"files"系统获取。常见原因包括：

数据集的数据不是来自文件（例如，它来自数据库或 Cassandra，或来自远程 THREDDS、HYRAX 或 GRADS 数据服务器）。
直接源文件是.nc ml 文件，它指定如何动态修改实际数据文件。
ERDDAP管理员选择不提供源数据文件。

如果您想要的数据集的源文件不可用，您可以向此ERDDAP的管理员erd dot data at noaa dot gov发送电子邮件，请求提供这些文件，但这些文件不可用通常是有原因的。

非 FTP

我们理解有些用户可能更喜欢ERDDAP通过 FTP 而不是 HTTP 提供文件，就像"files"所做的那样。抱歉。希望您能够使用当前的"files"系统完成您需要做的事情。

请求压缩文件

ERDDAP不提供存储在压缩文件（例如.zip或.gzip ）中的结果。相反， ERDDAP会在客户端发送的HTTP GET请求标头中查找accept-encoding （外部链接）

如果在 accept-encoding 列表中找到了受支持的压缩类型（ gzip 、 x-gzip或deflate ）， ERDDAP会在 HTTP 响应标头中包含“content‑encoding”，并在传输数据时对其进行压缩。客户端程序负责查找content-encoding并相应地解压缩数据。请求压缩是可选的，但压缩响应通常要快 3-10 倍，因此如果您要下载大量大文件，这将节省大量时间。（请注意，请求压缩的 .png 文件没有任何好处，因为文件的内容已经压缩。）

默认情况下，浏览器和OPeNDAP客户端总是请求压缩数据并解压返回的数据。
使用curl时，在命令行中添加--compressed以告诉curl请求压缩响应并自动解压缩。
对于其他客户端软件，您已明确设置了这一点。
这是一个Java示例。
这是一个Python示例（尽管您应该处理deflate的响应或者不请求deflate ）。

使用curl进行命令行下载

如果您要从ERDDAP下载一系列文件，则不必在浏览器中请求每个文件的ERDDAP URL，然后等待每个文件下载。使用curl方法：

如果您熟悉编写计算机程序（例如使用 C、 Java 、 Python 、 Matlab 、r），您可以编写一个带有循环的程序来导入所有所需的数据文件。
如果您熟悉命令行程序（只需运行程序，或在 Linux 或 Mac OS X 中使用 bash 或 tcsh 脚本，或在 Windows 中使用批处理文件），您可以使用curl将ERDDAP的结果文件保存到硬盘上的文件中，而无需使用浏览器或编写计算机程序。

ERDDAP + curl功能非常强大，可让您以多种新方式使用ERDDAP 。要安装curl ：

在 Linux 和 Mac OS X 上， curl可能已安装为 /usr/bin/ curl 。
在 Windows 上，或者如果你的计算机还没有安装curl ，则需要下载curl 并安装它。要进入 Windows 中的命令行，请单击 Windows 图标并在搜索文本字段中键入cmd 。（“Win32 - 通用、Win32、二进制（无 SSL）”在 Windows 7 中对我有用。）

请善待其他ERDDAP用户：一次只运行一个脚本或curl命令。

有关使用curl说明，请参阅curl手册页 (external link) 在这个curl教程中。但这里有一个关于使用curl与ERDDAP相关的快速教程：

要下载并保存一个文件，请使用
curl --compressed -g "erddapUrl" -o fileDir/fileName.ext
其中--compressed告诉curl请求压缩响应并自动解压缩，
  -g禁用curl的通配符功能，
  erddapUrl是请求数据或图像文件的任何ERDDAP URL，并且
  -o fileDir/fileName.ext指定将创建的文件的名称。
例如，
```
 curl --compressed -g "https://coastwatch.pfeg.noaa.gov/erddap/files/cwwcNDBCMet/nrt/NDBC_41008_met.nc" -o ndbc/41008.nc
```
在curl中，与在许多其他程序中一样，erddapUrl 的查询部分必须进行百分比编码：参数值中除 A-Za-z0-9_-!.~'()* 之外的所有字符（ '='符号后的部分）都必须编码为 %HH，其中 HH 是字符的 2 位十六进制值，例如空格变为 %20。#127 以上的字符必须转换为 UTF-8 字节，然后每个 UTF-8 字节都必须进行百分号编码（请程序员帮忙）。有些网站可以帮您进行百分号编码和解码。如果您从浏览器的地址文本字段获取 URL，则可能已经完成。
要通过一个步骤下载并保存多个文件，请使用启用了 globbing 功能的curl ：
curl --compressed "erddapUrl" -o fileDir/fileName#1.ext
由于通配符将字符 [、]、{ 和 } 视为特殊字符，因此您还必须进行百分比编码在 erddapURL 中分别将它们替换为 %5B、%5D、%7B、%7D。幸运的是，这些几乎从来不会出现在"files"文件名中。然后，在 erddapUrl 中，将零填充的数字（例如01 ）替换为值范围（例如[01-15] ），或将子字符串（例如41008 ）替换为值列表（例如{41008,41009,41010} ）。输出 fileName 中的#1会导致范围或列表的当前值被放入输出 fileName 中。例如，
```
 curl --compressed "https://coastwatch.pfeg.noaa.gov/erddap/files/cwwcNDBCMet/nrt/NDBC_{41008,41009,41010}_met.nc" -o ndbc/#1.nc
```

查看媒体文件

对于最常见的图像和视频文件类型， "files"系统现在将在文件名左侧显示一个“？”图标。如果您将鼠标悬停在该图标上，您将看到一个显示图像或音频或视频播放器的弹出窗口。

类似地，对于一些音频文件类型（特别是 .mp3、.ogg 和 .wav），您将看到一个音频控件，它允许您收听音频文件。

这些预览功能仅适用于某些文件类型、某些浏览器和某些操作系统。它们依赖于浏览器功能，因此在很大程度上不受我们控制。

或者，如果您单击图像、音频或视频文件的链接，查看器或播放器将在单独的窗口中打开。（如果您的浏览器询问您要对文件执行什么操作，请告诉它处理媒体文件本身（而不是通过其他软件），并告诉它记住此选择，以便将来自动使用。）

“我该如何处理这些文件？”

ERDDAP的主要功能之一是，它允许您以任何您想要的文件格式下载数据集的子集（通过数据集的数据访问表单），或者通过数据集的“制作图表”网页制作可自定义的图表和地图（这样您就不必下载数据文件或安装任何制图软件）。这样，您就不必使用您不熟悉和/或不想使用的文件格式的原始源数据文件。

如果您选择下载并使用ERDDAP的"files"系统提供的原始源文件，则必须弄清楚如何处理这些文件。幸运的是，有很多软件工具可用于处理各种文件类型：

所有文件类型
对于所有类型的文件，您都可以在FileInfo.com等网站上查找文件扩展名 . 提供文件类型的基本描述，并列出可用于处理文件的软件（查看、读取、写入、编辑等）。或者，您可以使用您最喜欢的搜索引擎来搜索您想要的内容。
音频文件（例如 .3gp、.aiff、.au、.flac、.mp3、.ogg、.pcm、.wav、.wma）
收听"files"系统提供的大多数音频文件的最简单方法是使用ERDDAP系统在浏览器中查看媒体文件，因为您不必下载文件或安装任何软件。
请参阅Wikipedia音频文件格式列表。
如果您想使用这些文件执行其他操作，有许多程序可以播放和编辑音频文件，包括：
- Windows Media Player 随 Windows 一起提供（查看 Windows 的“开始”列表）。
- Apple 的 iTunes 音频播放器附带 Mac OS X（在应用程序文件夹中查找），并且可供 Windows 免费下载。
- Ardour 和Audacity 是在 Linux、Mac OSX 和 Windows 上录制、编辑、混合和掌握音频的开源程序。
- 请参阅Wikipedia音频播放器软件比较。
- 请参阅Wikipedia数字音频编辑器比较。
- 还有更多。使用您最喜欢的搜索引擎来搜索您想要的内容。
HDF文件 (.hdf )
HDF .hdf 是一种常见的二进制数据文件类型。有一些软件包可以处理.hdf文件，包括：
- NASA's Panoply 是免费的、常用的软件，可以从.hdf文件制作图形和地图。
- HDF 5 库是HDF集团用于读取和写入所有.hdf文件的官方库。
- 一些分析程序，如Matlab 以及R 语言可以通过附加库读取.hdf文件。
- 许多用于.nc文件的工具也适用于.hdf文件。
图像文件（例如 .gif、.jpeg、.png、.tiff、.webp）
查看"files"系统提供的大多数图像文件的最简单方法是使用ERDDAP系统在浏览器中查看媒体文件，因为您不必下载文件或安装任何软件。
请参阅Wikipedia图像文件格式列表。
如果您想对图像文件进行其他操作，有许多图像查看和编辑程序可供选择，包括：
- Paint 随 Windows 提供（在 Windows 附件下的 Windows 开始列表中查找）。
- Mac OS X 附带了不同的 Paint（查看应用程序文件夹）。
- Gimp ，一个适用于所有操作系统的开源程序。
- IrfanView ，一个适用于 Windows 的免费图像编辑器。
- Adobe 的各种软件，包括Photoshop 。
- 请参阅Wikipedia光栅图形编辑器比较。
- 还有更多。使用您最喜欢的搜索引擎来搜索您想要的内容。
NetCDF文件 (.nc )
NetCDF .nc 是一种常见的二进制数据文件类型。
.nc文件有两个子类别：版本 3 文件（仍被广泛使用）和版本 4 文件（实际上是.hdf文件，但有一些变化）。这两个版本的文件都具有扩展名.nc ，并且可以被读取.nc文件的程序读取。
有大量软件包可以处理.nc文件，其中包括：
- 制作图表和地图的免费、常用软件是NASA's Panoply 和Ncview （也可以通过Conda安装）。
- NCO ，一个强大的命令行工具，用于永久修改.nc文件。
- NetCDF -C 和NetCDF - Java ，C、C++、Fortran 或Java读写.nc文件的主要软件库。
- 许多分析程序，例如Ferret 、 Matlab 以及R 语言可以读取.nc文件（可能通过附加库），制作图形和地图，并处理.nc文件中的数据。
- 许多其他软件程序可以读取（并处理） .nc文件。请参阅此列表。
文本文件（例如 .csv、 .tsv 、.txt）
文本文件与文字处理文件不同，文字处理文件具有特殊的嵌入式格式化命令。如果您将文本文件导入文字处理器并对文件进行更改，请确保再次将文件保存为 ASCII 文本文件。或者，使用文本编辑器程序来避免此问题。
如果您编辑.tsv （制表符分隔值）文件，请务必小心维护将每行不同“列”中的值分隔开的制表符。默认情况下（即使在许多文本编辑器中），制表符通常显示为空格（或几个空格）。因此，请务必使用编辑器的使制表符可见（作为特殊符号）的功能，以便您可以维护值之间的制表符。
.xml 文件从技术上讲是文本文件，但使用单独的 XML 编辑器处理它们有优势。
每个操作系统都有几十种文本编辑器程序，其中包括：
- 记事本随 Windows 提供（在 Windows 附件下的 Windows 开始列表中查找）。
- TextEdit 随 Mac OS X 附带（查看应用程序文件夹）。
- 大多数 Linux 版本都附带一些文本编辑器，其中一个是默认的（您可以更改）。如果您使用的是 Linux，那么您可能已经有了一个最喜欢的编辑器。
- 参见Wikipedia文本编辑器比较。
- 还有更多。使用您最喜欢的搜索引擎来搜索您想要的内容。
视频文件（例如 .avi、.flv、.mov、.mp4、.ogg、.ogv、.webm、.wmv）
查看"files"系统提供的大多数视频文件的最简单方法是使用ERDDAP系统在浏览器中查看媒体文件，因为您不必下载文件或安装任何软件。
请参阅Wikipedia视频文件格式列表。
如果您想对视频文件进行其他操作，有许多视频播放和编辑程序可供选择，包括：
- Windows Media Player 随 Windows 一起提供（查看 Windows 的“开始”列表）。
- Windows 视频编辑器随 Windows 一起提供（查看 Windows 的“开始”列表）。
- QuickTime Player（查看器）随 Mac OS X 一起提供（在应用程序文件夹中查找）。
- iMovie（编辑器）附带 Mac OS X（在应用程序文件夹中查找）。
- 不同的 Linux 发行版附带不同的视频播放器。Linux 上有许多开源和商业视频播放器和编辑器。使用您最喜欢的搜索引擎搜索您想要的内容。
- 请参阅Wikipedia视频播放器软件比较。
- 请参阅Wikipedia视频编辑软件比较。
- 还有更多。使用您最喜欢的搜索引擎来搜索您想要的内容。
XML 文件（例如 .xml）
XML 文件是结构化的文本文件。您可以在浏览器或文本编辑器中查看它们，但也有专门用于处理 XML 文件的软件。请参阅Wikipedia XML 编辑器比较。

字节范围请求

与ERDDAP中大多数其他资源的请求不同，对"files"系统（ .nc和.hdf文件除外）的文件的请求可能在标头中包含"Range"请求，该请求指定要返回的字节范围，而不是整个文件。请参阅Byte_serving (external link)

一些客户端软件（例如，网络浏览器中的音频和视频播放器）使用它来请求文件的块而不是整个文件。

通过字节范围访问远程文件通常很慢且效率低下。有时，读取远程文件的小样本（尤其是音频和视频文件）是值得的。但是，您需要访问文件的次数越多，下载文件然后使用本地文件就越高效。

ERDDAP的"files"系统拒绝对.nc和.hdf文件的所有字节范围请求，因此不要尝试使用 Netcdf-java/c、ncview、 Ferret或其他软件工具连接到ERDDAP的"files"系统提供的.nc或.hdf文件，就好像它们是本地文件一样。这些请求被阻止，因为这种方法效率极低，而且经常导致其他问题。相反：

使用(OPeN)DAP客户端软件连接到ERDDAP的数据集DAP服务（URL 中包含 /griddap/ 或 / tabledap /）。这就是DAP的用途。
或者，使用数据集的数据访问表单来请求数据子集。
或者，如果您需要整个文件或长时间重复访问，请使用curl 、 wget或浏览器从"files"系统下载整个文件，然后从文件的本地副本访问数据。