Tiled
Tiled is a data access service for data-aware portals and data science tools. Tiled has a Python client and integrates naturally with Python data science libraries, but nothing about the service is Python-specific; it also works from a web browser or any Internet-connected program.
Tiled’s service can sit atop databases, filesystems, and/or remote services to enable search and structured, chunkwise access to data in an extensible variety of appropriate formats, providing data in a consistent structure regardless of the format the data happens to be stored in at rest. The natively-supported formats span slow but widespread interchange formats (e.g. CSV, JSON) and fast, efficient ones (e.g. C buffers, Apache Arrow and Parquet). Tiled enables slicing and sub-selection to read and transfer only the data of interest, and it enables parallelized download of many chunks at once. Users can access data with very light software dependencies and fast partial downloads.
Tiled puts an emphasis on structures rather than formats, including:
N-dimensional strided arrays (i.e. numpy-like arrays)
Sparse arrays
Tabular data (e.g. pandas-like “dataframes”)
Nested, variable-sized data (as implemented by AwkwardArray)
Hierarchical structures thereof (e.g. xarrays, HDF5-compatible structures like NeXus)
Tiled implements extensible access control enforcement based on web security standards, similar to JuptyerHub. Like Jupyter, Tiled can be used by a single user or deployed as a shared public or private resource. Tiled can be configured to use third party services for login, such as Google, ORCID. or any OIDC or SAML authentication providers.
Tiled facilitates client-side caching in a standard web browser or in Tiled’s Python client, making efficient use of bandwidth. It uses service-side caching of “hot” datasets and resources to expedite both repeat requests (e.g. when several users are requesting the same chunks of data) and distinct requests for different parts of the same dataset (e.g. when the user is requesting various slices or columns from a dataset).
Distribution |
Where to get it |
---|---|
PyPI |
|
Conda |
|
Source code |
|
Documentation |
Example
In this example, we’ll serve of a collection of data that is generated in memory. Alternatively, it could be read on demand from a directory of files, network resource, database, or some combination of these.
tiled serve demo
# equivalent to:
# tiled serve pyobject --public tiled.examples.generated:tree
And then access the data efficiently via the Python client, a web browser, or any HTTP client.
>>> from tiled.client import from_uri
>>> client = from_uri("http://localhost:8000")
>>> client
<Container {'short_table', 'long_table', 'structured_data', ...} ~10 entries>
>>> list(client)
'big_image',
'small_image',
'tiny_image',
'tiny_cube',
'tiny_hypercube',
'low_entropy',
'high_entropy',
'short_table',
'long_table',
'labeled_data',
'structured_data']
>>> client['medium_image']
<ArrayClient>
>>> client['medium_image'][:]
array([[0.49675483, 0.37832119, 0.59431287, ..., 0.16990737, 0.5396537 ,
0.61913812],
[0.97062498, 0.93776709, 0.81797714, ..., 0.96508877, 0.25208564,
0.72982507],
[0.87173234, 0.83127946, 0.91758202, ..., 0.50487542, 0.03052536,
0.9625512 ],
...,
[0.01884645, 0.33107071, 0.60018523, ..., 0.02268164, 0.46955907,
0.37842628],
[0.03405101, 0.77886243, 0.14856727, ..., 0.02484926, 0.03850398,
0.39086524],
[0.16567224, 0.1347261 , 0.48809697, ..., 0.55021249, 0.42324589,
0.31440635]])
>>> client['long_table']
<DataFrameClient ['A', 'B', 'C']>
>>> client['long_table'].read()
A B C
index
0 0.246920 0.493840 0.740759
1 0.326005 0.652009 0.978014
2 0.715418 1.430837 2.146255
3 0.425147 0.850294 1.275441
4 0.781036 1.562073 2.343109
... ... ... ...
99995 0.515248 1.030495 1.545743
99996 0.639188 1.278376 1.917564
99997 0.269851 0.539702 0.809553
99998 0.566848 1.133695 1.700543
99999 0.101446 0.202892 0.304338
[100000 rows x 3 columns]
>>> client['long_table'].read(['A', 'B'])
A B
index
0 0.246920 0.493840
1 0.326005 0.652009
2 0.715418 1.430837
3 0.425147 0.850294
4 0.781036 1.562073
... ... ...
99995 0.515248 1.030495
99996 0.639188 1.278376
99997 0.269851 0.539702
99998 0.566848 1.133695
99999 0.101446 0.202892
Using an Internet browser or a command-line HTTP client like curl or httpie you can download the data in whole or in efficiently-chunked parts in the format of your choice:
# Download tabular data as CSV
http://localhost:8000/api/v1/table/full/long_table?format=csv
# or XLSX (Excel)
http://localhost:8000/api/v1/table/full/long_table?format=xslx
# and subselect columns.
http://localhost:8000/api/v1/table/full/long_table?format=xslx&field=A&field=B
# View or download (2D) array data as PNG
http://localhost:8000/api/v1/array/full/medium_image?format=png
# and slice regions of interest.
http://localhost:8000/api/v1/array/full/medium_image?format=png&slice=:50,100:200
Web-based data access usually involves downloading complete files, in the manner of Globus; or using modern chunk-based storage formats, such as TileDB and Zarr in local or cloud storage; or using custom solutions tailored to a particular large dataset. Waiting for an entire file to download when only the first frame of an image stack or a certain column of a table are of interest is wasteful and can be prohibitive for large longitudinal analyses. Yet, it is not always practical to transcode the data into a chunk-friendly format or build a custom tile-based-access solution. (Though if you can do either of those things, you should consider them instead!)
- Use Profiles to streamline Python client setup
- Use Performance and Debug Logging
- Run Tiled Server in a Container
- Serve Data using Configuration Files
- Serve Files with Custom Formats
- Add Custom Export Formats
- Create and Use API Keys
- Custom Python Client Objects
- Prometheus Metrics
- Use Tiled in Python without an HTTP server
- Set up a database for a scaled authenticated deloyment
- Register Content in Tiled
- Service-side Components
- Adapters
- Python Object Adapters
- File Adapters
- tiled.adapters.csv.read_csv
- tiled.adapters.excel.ExcelAdapter
- tiled.adapters.hdf5.HDF5Adapter
- tiled.adapters.netcdf.read_netcdf
- tiled.adapters.parquet.ParquetDatasetAdapter
- tiled.adapters.sparse_blocks_parquet.SparseBlocksParquetAdapter
- tiled.adapters.tiff.TiffAdapter
- tiled.adapters.zarr.ZarrArrayAdapter
- tiled.adapters.zarr.ZarrGroupAdapter
- Search Queries
- Media Type (Format) Registry
- Structures
- Configuration Parsing
- HTTP Server Application
- Resource Cache
- Adapters
- HTTP API
- Python Client
- Constructors
- Client Container
- tiled.client.container.Container.get
- tiled.client.container.Container.keys
- tiled.client.container.Container.items
- tiled.client.container.Container.values
- tiled.iterviews.ValuesView.first
- tiled.iterviews.ValuesView.last
- tiled.iterviews.ValuesView.head
- tiled.iterviews.ValuesView.tail
- tiled.client.container.Container.metadata
- tiled.client.container.Container.sorting
- tiled.client.container.Container.uri
- tiled.client.container.Container.specs
- tiled.client.container.Container.search
- tiled.client.container.Container.sort
- tiled.client.container.Container.distinct
- tiled.client.container.Container.create_container
- tiled.client.container.Container.write_array
- tiled.client.container.Container.write_awkward
- tiled.client.container.Container.write_dataframe
- tiled.client.container.Container.write_sparse
- tiled.client.container.Container.new
- Structure Clients
- Base
- tiled.client.base.BaseClient
- tiled.client.base.BaseClient.formats
- tiled.client.base.BaseClient.metadata
- tiled.client.base.BaseClient.metadata_copy
- tiled.client.base.BaseClient.replace_metadata
- tiled.client.base.BaseClient.update_metadata
- tiled.client.base.BaseClient.patch_metadata
- tiled.client.base.BaseClient.build_metadata_patches
- tiled.client.base.BaseClient.uri
- tiled.client.base.BaseClient.structure_family
- tiled.client.base.BaseClient.item
- tiled.client.base.BaseClient.login
- tiled.client.base.BaseClient.logout
- tiled.client.base.BaseClient.new_variation
- tiled.client.base.BaseClient.specs
- tiled.client.base.BaseClient.structure
- Array
- tiled.client.array.DaskArrayClient
- tiled.client.array.DaskArrayClient.read_block
- tiled.client.array.DaskArrayClient.read
- tiled.client.array.DaskArrayClient.export
- tiled.client.array.DaskArrayClient.write
- tiled.client.array.DaskArrayClient.write_block
- tiled.client.array.ArrayClient
- tiled.client.array.ArrayClient.read_block
- tiled.client.array.ArrayClient.read
- tiled.client.array.ArrayClient.export
- tiled.client.array.ArrayClient.write
- tiled.client.array.ArrayClient.write_block
- Awkward
- tiled.client.awkward.AwkwardClient
- tiled.client.awkward.AwkwardClient.read
- tiled.client.awkward.AwkwardClient.write
- tiled.client.awkward.AwkwardClient.export
- tiled.client.array.ArrayClient
- tiled.client.array.ArrayClient.read_block
- tiled.client.array.ArrayClient.read
- tiled.client.array.DaskArrayClient.export
- Sparse Array
- DataFrame
- tiled.client.dataframe.DaskDataFrameClient
- tiled.client.dataframe.DaskDataFrameClient.read_partition
- tiled.client.dataframe.DaskDataFrameClient.read
- tiled.client.dataframe.DaskDataFrameClient.export
- tiled.client.dataframe.DaskDataFrameClient.write
- tiled.client.dataframe.DaskDataFrameClient.write_partition
- tiled.client.dataframe.DataFrameClient
- tiled.client.dataframe.DataFrameClient.read_partition
- tiled.client.dataframe.DataFrameClient.read
- tiled.client.dataframe.DataFrameClient.export
- tiled.client.dataframe.DataFrameClient.write
- tiled.client.dataframe.DataFrameClient.write_partition
- Xarray Dataset
- Base
- Context
- tiled.client.context.Context
- tiled.client.context.Context.from_any_uri
- tiled.client.context.Context.from_app
- tiled.client.context.Context.authenticate
- tiled.client.context.Context.cache
- tiled.client.context.Context.force_auth_refresh
- tiled.client.context.Context.login
- tiled.client.context.Context.logout
- tiled.client.context.Context.tokens
- Cache
- tiled.client.cache.Cache
- tiled.client.cache.Cache.capacity
- tiled.client.cache.Cache.clear
- tiled.client.cache.Cache.close
- tiled.client.cache.Cache.count
- tiled.client.cache.Cache.delete
- tiled.client.cache.Cache.filepath
- tiled.client.cache.Cache.get
- tiled.client.cache.Cache.max_item_size
- tiled.client.cache.Cache.readonly
- tiled.client.cache.Cache.set
- tiled.client.cache.Cache.size
- tiled.client.cache.Cache.write_safe
- Sync
- Queries
- Built in query types
- Query expressions
- Convenience Functions
- Custom queries
- Authentication Details
- Scopes
- Command-line tool
- Service Configuration Reference
- Configuration merging rules
- Environment variable expansion
- trees
- media_types
- file_extensions
- authentication
- database
- access_control
- object_cache
- response_bytesize_limit
- allow_origins
- uvicorn
- metrics
- specs
- reject_undeclared_specs
- expose_raw_assets
- Client Profiles Reference
- Release History
- Minimum Version of Python and NumPy