You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+15-54Lines changed: 15 additions & 54 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,68 +14,29 @@ View, curate, and share results of electrophysiological spike sorting in the bro
14
14
pip install --upgrade sortingview
15
15
```
16
16
17
-
If you want to generate shareable URLs, configure your [kachery-cloud](https://github.com/scratchrealm/kachery-cloud) client
17
+
## Kachery Setup
18
18
19
-
```bash
20
-
kachery-cloud-init
21
-
# follow the instructions to associate your client with your Google user name on kachery-cloud
22
-
```
23
-
24
-
## Getting started
25
-
26
-
See the [examples folder](./examples) or the [example notebook](./notebooks/sortingview_jupyter.ipynb).
19
+
In order to use sortingview, you must configure kachery in order to share files on the kachery network.
27
20
28
-
SortingView widgets can be viewed in any of the following modes:
29
-
* shareable URL in the browser
30
-
*[jupyter widget](./doc/jupyter_integration.md) (probably not working - needs to be updated)
21
+
Visit this site to register and obtain an API key:
31
22
32
-
## SpikeInterface Integration
23
+
https://kachery.vercel.app
33
24
34
-
We are working on a tight integration between SortingView and [SpikeInterface](https://spikeinterface.readthedocs.io/en/latest/).
35
-
36
-
## Environment
37
-
38
-
You can use environment variables to control the storage/configuration directory used by kachery-cloud, the project ID used for storing data in the cloud, and the options for creating figures.
25
+
Then set the following environment variables
39
26
40
27
```bash
41
-
# Set the storage/configuration directory used by kachery-cloud
42
-
# If unset, $HOME/.kachery-cloud will be used
43
-
# The client ID will be determined by this directory
44
-
# You can share the same kachery-cloud directory between multiple users,
45
-
# but you will need to set mult-user mode for the client
46
-
export KACHERY_CLOUD_DIR="..."
47
-
48
-
# Set the project ID for storing data in the cloud
49
-
# If unset, the default project associated with the client will be used
50
-
# The default project can be configured at https://cloud.kacheryhub.org
51
-
export KACHERY_CLOUD_PROJECT_ID="..."
52
-
53
-
# When using local mode for figURLs, data will not be uploaded/downloaded
54
-
# from the cloud, and the URLs will not be shareable.
55
-
# As an alternative to using the env variable, you can also use
56
-
# local=True as an argument to .url() in all of the views.
57
-
# See below for more information.
58
-
export SORTINGVIEW_LOCAL=1
59
-
60
-
# Electron mode is similar to local mode, except instead of returning
61
-
# a URL, an electron window will open and data will be accessed directly
62
-
# from the file system. I.e., no browser.
63
-
# This requires installation of figurl-electron (see below).
64
-
# See below for more information.
65
-
export SORTINGVIEW_ELECTRON=1 # Requires installation of figurl-electron
28
+
export KACHERY_API_KEY = "the-api-key"
29
+
export KACHERY_ZONE = "scratch"
66
30
```
67
31
68
-
It is recommend that you set these variables in your `~/.bashrc` file.
32
+
You can use the scratch zone to get started, but the files in that zone will be cleared out periodically. For more persistent storage (which is also not guaranteed to persist forever), you'll need to set up your own zone.
69
33
70
-
## Sharing the kachery cloud directory between multiple users
34
+
## Getting started
71
35
72
-
On a shared system, you may want to share your kachery cloud directory between multiple users so that
73
-
they can utilize the same local files. Follow these steps:
36
+
See the [examples folder](./examples).
74
37
75
-
* Create a new kachery cloud directory in a location where the users may access it
76
-
with read and write permissions. For example, this could be on a shared drive.
77
-
* Have each user set the KACHERY_CLOUD_DIR environment variable to point to this
78
-
directory on their system (see above)
79
-
* Have the main user (the one who will own the client) initialize the client as usual via
80
-
`kachery-cloud-init`
81
-
* Here's the tricky part. You must configure your system such that newly created files in the directory are readable and writeable by all the users with access. This is probably best accomplished using group permissions.
0 commit comments