Skip to content

Commit 079b290

Browse files
committed
more complete table
1 parent 8c77986 commit 079b290

File tree

1 file changed

+46
-1
lines changed

1 file changed

+46
-1
lines changed

doc/user-guide/io.rst

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,12 @@ Remote URL Resolution
173173
- ❌
174174
- ❌
175175
- ❌
176+
* - ``http://test.opendap.org/dap4/file.nc4?dap4.ce=/time[0]``
177+
- ✅
178+
- ❌
179+
- ❌
180+
- ✅
181+
- ❌
176182
* - ``dap2://opendap.nasa.gov/dataset``
177183
- ❌
178184
- ❌
@@ -185,10 +191,25 @@ Remote URL Resolution
185191
- ❌
186192
- ✅
187193
- ❌
194+
* - ``http://test.opendap.org/dap4/file.nc4``
195+
- ✅
196+
- ✅
197+
- ❌
198+
- ✅
199+
- ❌
200+
* - ``https://example.com/DAP4/data.nc``
201+
- ✅
202+
- ✅
203+
- ❌
204+
- ✅
205+
- ❌
188206

189207
Local File Resolution
190208
~~~~~~~~~~~~~~~~~~~~~
191209

210+
For local files, backends first try to read the file's **magic number** (first few bytes).
211+
If the magic number cannot be read, they fall back to checking the file **extension**.
212+
192213
.. list-table::
193214
:header-rows: 1
194215
:widths: 40 20 10 10 10 10
@@ -202,7 +223,7 @@ Local File Resolution
202223
* - ``/path/to/file.nc``
203224
- ``CDF\x01`` (netCDF3)
204225
- ✅
205-
-
226+
-
206227
- ✅
207228
- ❌
208229
* - ``/path/to/file.nc4``
@@ -223,6 +244,30 @@ Local File Resolution
223244
- ❌
224245
- ❌
225246
- ✅
247+
* - ``/path/to/file.nc``
248+
- *(no magic number)*
249+
- ✅
250+
- ✅
251+
- ✅
252+
- ❌
253+
* - ``/path/to/file.xyz``
254+
- ``CDF\x01`` (netCDF3)
255+
- ✅
256+
- ❌
257+
- ✅
258+
- ❌
259+
* - ``/path/to/file.xyz``
260+
- ``\x89HDF\r\n\x1a\n`` (HDF5/netCDF4)
261+
- ✅
262+
- ✅
263+
- ❌
264+
- ❌
265+
* - ``/path/to/file.xyz``
266+
- *(no magic number)*
267+
- ❌
268+
- ❌
269+
- ❌
270+
- ❌
226271

227272
.. note::
228273
Remote URLs ending in ``.nc`` are **ambiguous**:

0 commit comments

Comments
 (0)