jpeg
Driver¶
The jpeg
driver specifies a TensorStore backed by a jpeg.
The read volume is indexed by “height” (y), “width” (x), “channel”.
- json driver/jpeg : object¶
- Extends:¶
TensorStoreKvStoreAdapter
— Specifies a TensorStore stored using a base key-value store.
- Required members:¶
-
driver :
"jpeg"
¶
- kvstore : KvStore | KvStoreUrl¶
Base key-value store for the TensorStore.
-
driver :
- Optional members:¶
-
-
dtype :
"uint8"
¶ Optional. If specified, must be
"uint8"
.
-
rank : integer[
0
,32
]¶ Specifies the rank of the TensorStore.
If
transform
is also specified, the input rank must match. Otherwise, the rank constraint applies to the driver directly.
- transform : IndexTransform¶
Specifies a transform.
- schema : Schema¶
Specifies constraints on the schema.
When opening an existing array, specifies constraints on the existing schema; opening will fail if the constraints do not match. Any soft constraints specified in the
chunk_layout
are ignored. When creating a new array, a suitable schema will be selected automatically based on the specified schema constraints in combination with any driver-specific constraints.
-
path : string =
""
¶ Additional path relative to
kvstore
.This is joined as an additional
"/"
-separated path component after anypath
member directly withinkvstore
. This is supported for backwards compatibility only; theKvStore.path
member should be used instead.Example
"path/to/data"
-
cache_pool : ContextResource =
"cache_pool"
¶ Cache pool for data.
Specifies or references a previously defined
Context.cache_pool
. It is normally more convenient to specify a defaultcache_pool
in thecontext
.
-
data_copy_concurrency : ContextResource =
"data_copy_concurrency"
¶ Specifies or references a previously defined
Context.data_copy_concurrency
. It is normally more convenient to specify a defaultdata_copy_concurrency
in thecontext
.
-
recheck_cached_data : CacheRevalidationBound =
"open"
¶ Time after which cached data is assumed to be fresh.
Cached data older than the specified time is revalidated prior to being returned from a read operation. Writes are always consistent regardless of the value of this option.
Specifying
true
means that the data will be revalidated prior to every read operation. With a value of"open"
, any cached data is revalidated when the TensorStore is opened but is not rechecked for each read operation.Note
To enable in-memory data caching, you must both specify a
cache_pool
with a non-zerototal_bytes_limit
and also specifyfalse
,"open"
, or an explicit time bound forrecheck_cached_data
.
-
quality : number =
75
¶ Unused. JPEG Encoding quality in the range 0..100.
-
dtype :
Example
{"driver": "jpeg", "kvstore": "gs://my-bucket/path-to-image.jpg"}
- json TensorStoreUrl/jpeg : string¶
jpeg:
TensorStore URL schemeJPEG TensorStores may be specified using the
jpeg:
URL syntax.Examples
URL representation
JSON representation
"gs://my-bucket/path-to-image.jpg/|jpeg:"
{"driver": "jpeg", "kvstore": {"driver": "gcs", "bucket": "my-bucket", "path": "path-to-image.jpg"} }
- Extends:¶
TensorStoreUrl
— URL representation of a TensorStore to open.
Auto detection¶
This driver supports auto-detection based on the signature at the start of the file.