From 015fe7a4e05a3ce3efedc080b8dd70214896813c Mon Sep 17 00:00:00 2001 From: eileenrmartin Date: Mon, 16 Dec 2024 15:11:30 -0700 Subject: [PATCH 1/2] segyio dependency issue note made next to install instructions --- docs/index.qmd | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/index.qmd b/docs/index.qmd index ea003ce5..cfe3b77c 100644 --- a/docs/index.qmd +++ b/docs/index.qmd @@ -128,6 +128,10 @@ See [this recipe](recipes/docker_basic.qmd) for installation with Docker. See the [contributing docs](contributing/contributing.qmd) for development installations. +Please note that there is currently a fix in progress for the dependency issue with segyio, +which does not yet support Python 3.13, so that segyio will be an optional dependency. For +the time being, please use Python 3.12 for the environment. + # Feedback and Support Use the [project discussions](https://github.com/DASDAE/dascore/discussions) to ask a question. From f16c2b90f86871c44211465fdf0e041ba598d9b3 Mon Sep 17 00:00:00 2001 From: Ahmad Tourei <92008628+ahmadtourei@users.noreply.github.com> Date: Mon, 16 Dec 2024 17:46:27 -0700 Subject: [PATCH 2/2] clarify fetch in tutorials (#468) --- docs/index.qmd | 13 ++++++++++--- docs/tutorial/patch.qmd | 4 ++++ docs/tutorial/spool.qmd | 13 +++++++++---- 3 files changed, 23 insertions(+), 7 deletions(-) diff --git a/docs/index.qmd b/docs/index.qmd index cfe3b77c..dddf58b9 100644 --- a/docs/index.qmd +++ b/docs/index.qmd @@ -39,10 +39,13 @@ print(out_str) ```{python} import dascore as dc -from dascore.utils.downloader import fetch +# Import fetch to read DASCore example files +from dascore.utils.downloader import fetch -# get a path to an example file, replace with your path +# Fetch a sample file path from DASCore file_path = fetch('terra15_das_1_trimmed.hdf5') +# To read DAS data stored locally on your machine, simply replace the above line with: +# file_path = "/path/to/data/directory/data.EXT" spool = dc.spool(file_path) patch = spool[0] @@ -53,10 +56,14 @@ patch = spool[0] ```{python} #| output: false import dascore as dc +# Import fetch to read DASCore example files from dascore.utils.downloader import fetch -# get a path to a directory of das files, replace with your path +# Fetch a sample file path from DASCore (just to get a usable path for the rest of the cell) directory_path = fetch('terra15_das_1_trimmed.hdf5').parent +# To read a directory of DAS data stored locally on your machine, +# simply replace the above line with: +# directory_path = "/path/to/data/directory/" spool = ( # Create a spool to interact with directory data diff --git a/docs/tutorial/patch.qmd b/docs/tutorial/patch.qmd index 1d30bdea..4d12b2b0 100644 --- a/docs/tutorial/patch.qmd +++ b/docs/tutorial/patch.qmd @@ -37,9 +37,13 @@ A single file can be loaded like this: #| code-fold: true # This codeblock is just to get a usable path for the next cell. import dascore as dc +# Import fetch to read DASCore example files from dascore.utils.downloader import fetch + path = fetch("terra15_das_1_trimmed.hdf5") +# To read DAS data stored locally on your machine, simply replace the above line with: +# path = "/path/to/data/directory/data.EXT" ``` diff --git a/docs/tutorial/spool.qmd b/docs/tutorial/spool.qmd index a5d88c52..657f3b12 100644 --- a/docs/tutorial/spool.qmd +++ b/docs/tutorial/spool.qmd @@ -24,9 +24,12 @@ spool1 = dc.spool(patch_list) ```{python} import dascore as dc +# Import fetch to read DASCore example files from dascore.utils.downloader import fetch path_to_das_file = fetch("terra15_das_1_trimmed.hdf5") +# To read DAS data stored locally on your machine, simply replace the above line with: +# path_to_das_file = "/path/to/data/directory/data.EXT" spool2 = dc.spool(path_to_das_file) ``` @@ -35,12 +38,14 @@ spool2 = dc.spool(path_to_das_file) ```{python} import dascore as dc +# Import fetch to read DASCore example files from dascore.utils.downloader import fetch -# We use fetch to make sure the file is downloaded. You would -# just need to replace directory_path with your data directory path. -path_to_das_file = fetch("terra15_das_1_trimmed.hdf5") -directory_path = path_to_das_file.parent +# Fetch a sample file path from DASCore (just to get a usable path for the rest of the cell) +directory_path = fetch('terra15_das_1_trimmed.hdf5').parent +# To read a directory of DAS data stored locally on your machine, +# simply replace the above line with: +# directory_path = "/path/to/data/directory/" # Update will create an index of the contents for fast querying/access spool3 = dc.spool(directory_path).update()