Skip to content

docs: add cloud storage access documentation#567

Open
haoyu-haoyu wants to merge 2 commits intoMIT-LCP:mainfrom
haoyu-haoyu:docs/cloud-uri-access
Open

docs: add cloud storage access documentation#567
haoyu-haoyu wants to merge 2 commits intoMIT-LCP:mainfrom
haoyu-haoyu:docs/cloud-uri-access

Conversation

@haoyu-haoyu
Copy link
Copy Markdown

Summary

Document the fsspec-based cloud storage access feature (added in PR #523) which was never documented.

Content

New "Cloud Storage Access" section in docs/io.rst covering:

  • Supported protocols: s3://, gs://, az://, azureml://
  • Backend package installation (s3fs, gcsfs, adlfs)
  • Usage examples with rdrecord and rdann
  • Authentication guidance
  • Note clarifying that cloud URIs go in record_name, not pn_dir

Closes #547

Document the fsspec-based cloud/remote file access feature that was
added in PR MIT-LCP#523 but never documented. Covers:

- Supported protocols (S3, GCS, Azure, HTTPS)
- Installation of cloud extras
- Usage examples for rdrecord and rdann with remote paths
- Authentication guidance for credentialed cloud providers

Closes MIT-LCP#547
- Narrow supported protocols to s3://, gs://, az://, azureml://
  (matching actual code in _coreio.py)
- Remove non-existent wfdb[cloud] install extra — fsspec is already
  a core dependency; document per-provider backend packages instead
- Fix examples: cloud URIs go in record_name, not pn_dir
- Remove storage_options reference (not in public API)
- Add note clarifying pn_dir vs record_name semantics
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update README or documentation to explain how to access WFDB files from cloud URIs

1 participant