Awesome
<img src="./figurl.png" width="200px" />figurl
Figurl is a framework for creating browser-based, shareable, interactive views of scientific datasets in the cloud. It is designed to be used in collaborative environments, such as scientific research teams, and is built on top of Kachery cloud.
This package is intended for collaborative sharing of data for scientific research. It should not be used for other purposes. At this point, uploaded files are not guaranteed to be available for ever. Contact us if you are interested storing files using your own cloud resources.
Installation and setup
Note: most of the time, you will be using a different Python package that includes figurl as a dependency. But you can also install figurl directly and use the basic static functionality (Altair charts, markdown documents, reports).
It is recommended that you use a conda environment with Python >= 3.8 and numpy.
pip install --upgrade figurl
Configure your kachery-cloud client
kachery-cloud-init
# follow the instructions to associate your client with your GitHub user name on kachery-cloud
Static examples
To test the system, try running the scripts in the examples/ folder. Here are the example (static) figures:
Each of these links pair a visualization plugin (v query parameter) with a piece of data (d query parameter). For example, the Altair chart figURL:
Interactive examples
For examples of interactive figures, see intro to Figurl.
How it works
- Python script assembles the data and figure specifications.
- Data are uploaded to a content-addressable storage database in the cloud (Kachery).
- Python script generates a URL that pairs a visualization plugin (hosted in a cloud storage bucket) and the uploaded data.
- The shareable URL takes the user to figurl.org where the data is downloaded and sent to the visualization plugin for display.
Cloud storage
By default, your data files will be stored using our cloud resources, and they are not guaranteed to be available forever. You can also configure figurl to use your own resources by creating a Kachery zone.
Contributing
- Star us on GitHub
- Provide feedback
- Contact us if you would like to help develop and maintain this open source project
For developers
Authors
Jeremy Magland and Jeff Soules, Center for Computational Mathematics, Flatiron Institute
License
Apache 2.0