https://github.com/isl-org/open3d_downloads
Hosting Open3D test data for development use
https://github.com/isl-org/open3d_downloads
Last synced: 11 months ago
JSON representation
Hosting Open3D test data for development use
- Host: GitHub
- URL: https://github.com/isl-org/open3d_downloads
- Owner: isl-org
- License: other
- Created: 2021-02-26T05:35:36.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-30T18:25:42.000Z (over 1 year ago)
- Last Synced: 2025-01-08T16:22:21.258Z (about 1 year ago)
- Homepage:
- Size: 57.3 MB
- Stars: 25
- Watchers: 11
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Open3D-Downloads
Hosting Open3D test data for development use.
## (TL;DR) How to add a data file
- Small files (e.g. several MB)
- Step 1: Push the file to the `open3d_downloads` repo.
- Step 2: Get the **direct** download URL to the file. The URL typically
looks like `https://github.com/intel-isl/open3d_downloads/raw/master/path/to/file`.
You may get the URL by going to the file in the GitHub website, right
click on the "Download" button and select "Copy link address".
- Step 3: Back to the `Open3D` repo, edit
`Open3D/examples/test_data/download_file_list.json` to specify the
direct download URL and download path.
- Step 4: Done! When you re-build the `Open3D` project, the new file will
be downloaded to `Open3D/examples/test_data/open3d_downloads`. Now you
can use this file in your source code including unit tests.
- Large files (max 2GB)
- Step 1: Create a new release or re-use an existing release in the
`open3d_downloads` repo.
- Step 2: Upload your file as a release artifact. For files larger than 2GB,
you may split the files into parts with tools like `zip` or `tar`. After
uploading, you will able to get the direct download URL.
- Step 3: These files will not be downloaded automatically. You need to
add your own mechanisms to download and consume the files.
## When is the download triggered
Files listed in `Open3D/examples/test_data/download_file_list.json` will be
downloaded automatically in the following scenarios:
- when running CMake config steps
- when running Python unit tests
- when running Python examples/tutorials
## Permission control
Community developers can create pull requests to add new files to the
`open3d_downloads` repo. Internal developers can directly push to the
`open3d_downloads` repo's `master` branch and create/modify releases.