# Uses of Class
org.apache.sis.storage.DataStoreException

Packages that use DataStoreException
Package
Description
org.apache.sis.storage
Data store base types for retrieving and saving geospatial data in various storage formats.
org.apache.sis.storage.aggregate
Resources which are aggregations or concatenations of other resources.
org.apache.sis.storage.geotiff
A data store that can read and write GeoTIFF files as grid coverages.
org.apache.sis.storage.landsat
Reader of Landsat 8 level 1-2 data.
org.apache.sis.storage.modifier
A plugin mechanism for modifying some aspects of the resources read by data stores.
org.apache.sis.storage.netcdf
Reads netCDF files conforming to the Climate and Forecast (CF).
org.apache.sis.storage.sql
Data store capable to read and write features using a JDBC connection to a database.
org.apache.sis.storage.tiling
Base types for retrieving and saving tiles in resources.

- ## Uses of DataStoreException in org.apache.sis.storage

  Subclasses of DataStoreException in org.apache.sis.storage
  Modifier and Type
  Class
  Description
  `class`
  `CanNotProbeException`
  Thrown when an unrecoverable error occurred during the probing of a file.
  `class`
  `ConcurrentReadException`
  Thrown when an operation cannot be performed while a read operation is in progress.
  `class`
  `ConcurrentWriteException`
  Thrown when an operation cannot be performed while a write operation is in progress.
  `class`
  `DataStoreClosedException`
  Thrown when a data store is closed and can no more return data.
  `class`
  `DataStoreContentException`
  Thrown when a store cannot be read because the stream or database contains invalid data.
  `class`
  `DataStoreReferencingException`
  Thrown when a data store failed to construct the coordinate reference system (CRS) or other positioning information.
  `class`
  `ForwardOnlyStorageException`
  Thrown when an operation would require to move the cursor back, but the underlying storage does not allow that.
  `class`
  `IllegalFeatureTypeException`
  Thrown when a store cannot write the given feature because its type is not one of the supported types.
  `class`
  `IllegalNameException`
  Thrown when an invalid name is used for identifying a coverage, a feature or other kind of element in a data store.
  `class`
  `IllegalOpenParameterException`
  Thrown when a `DataStore` cannot be opened because of invalid parameters.
  `class`
  `IncompatibleResourceException`
  Thrown when a write operation cannot be performed because the resource to write is incompatible with the data store.
  `class`
  `InternalDataStoreException`
  Thrown when an internal error occurred in a `DataStore` implementation.
  `class`
  `NoSuchDataException`
  Thrown when requested data are not found in the data store.
  `class`
  `ReadOnlyStorageException`
  Thrown when a `DataStore` cannot perform a write operation.
  `class`
  `ResourceAlreadyExistsException`
  Thrown when a write operation cannot be performed because it would cause the replacement of an existing resource.
  `class`
  `UnsupportedEncodingException`
  Thrown when a storage uses some encoding options not supported by current implementation.
  `class`
  `UnsupportedQueryException`
  Thrown when a resources cannot be filtered with a given query.
  `class`
  `UnsupportedStorageException`
  Thrown when no `DataStoreProvider` is found for a given storage object.
  `class`
  `WriteOnlyStorageException`
  Thrown when a `DataStore` cannot perform a read operation.
  Methods in org.apache.sis.storage that return DataStoreException
  Modifier and Type
  Method
  Description
  `protected DataStoreException`
  AbstractGridCoverageResource.`canNotRead(String filename, GridGeometry request, Throwable cause)`
  Creates an exception for a failure to load data.
  `DataStoreException`
  DataStoreException.`initCause(Throwable cause)`
  Initializes the cause of this throwable to the specified value.
  Methods in org.apache.sis.storage that throw DataStoreException
  Modifier and Type
  Method
  Description
  `Resource`
  WritableAggregate.`add(Resource resource)`
  Adds a new `Resource` in this `Aggregate`.
  `void`
  WritableFeatureSet.`add(Iterator<? extends AbstractFeature> features)`
  Inserts new feature instances in this `FeatureSet`.
  `abstract void`
  DataStore.`close()`
  Closes this data store and releases any underlying resources.
  `void`
  StorageConnector.`closeAllExcept(Object view)`
  Closes all streams and connections created by this `StorageConnector` except the given view.
  `<S> S`
  StorageConnector.`commit(Class<S> type, String format)`
  Returns the storage as a view of the given type and closes all other views.
  `Collection<? extends Resource>`
  Aggregate.`components()`
  Returns the children resources of this aggregate.
  `protected Metadata`
  AbstractFeatureSet.`createMetadata()`
  Invoked in a synchronized block the first time that `getMetadata()` is invoked.
  `protected Metadata`
  AbstractGridCoverageResource.`createMetadata()`
  Invoked in a synchronized block the first time that `getMetadata()` is invoked.
  `protected Metadata`
  AbstractResource.`createMetadata()`
  Invoked in a synchronized block the first time that `AbstractResource.getMetadata()` is invoked.
  `protected GridCoverageResource`
  CoverageQuery.`execute(GridCoverageResource source)`
  Applies this query on the given coverage resource.
  `protected FeatureSet`
  FeatureQuery.`execute(FeatureSet source)`
  Applies this query on the given feature set.
  `Stream<AbstractFeature>`
  FeatureSet.`features(boolean parallel)`
  Returns a stream of all features contained in this dataset.
  `Resource`
  DataStore.`findResource(String identifier)`
  Searches for a resource identified by the given identifier.
  `Optional<Envelope>`
  AbstractGridCoverageResource.`getEnvelope()`
  Returns the envelope of the grid geometry if known.
  `Optional<Envelope>`
  AbstractResource.`getEnvelope()`
  Returns the spatiotemporal envelope of this resource.
  `Optional<Envelope>`
  DataSet.`getEnvelope()`
  Returns the spatiotemporal extent of this resource in its most natural coordinate reference system.
  `default Optional<Envelope>`
  GridCoverageResource.`getEnvelope()`
  Returns the spatiotemporal extent of this resource in its most natural coordinate reference system.
  `default Optional<Resource.FileSet>`
  Resource.`getFileSet()`
  Gets the paths to the files potentially used by this resource.
  `GridGeometry`
  GridCoverageResource.`getGridGeometry()`
  Returns the valid extent of grid coordinates together with the conversion from those grid coordinates to real world coordinates.
  `Optional<GenericName>`
  AbstractFeatureSet.`getIdentifier()`
  Returns the feature type name as the identifier for this resource.
  `Optional<GenericName>`
  AbstractResource.`getIdentifier()`
  Returns the resource persistent identifier if available.
  `Optional<GenericName>`
  DataStore.`getIdentifier()`
  Returns an identifier for the root resource of this data store, or an empty value if none.
  `Optional<GenericName>`
  Resource.`getIdentifier()`
  Returns the resource persistent identifier.
  `default RasterLoadingStrategy`
  GridCoverageResource.`getLoadingStrategy()`
  Returns an indication about when the "physical" loading of raster data will happen.
  `final Metadata`
  AbstractResource.`getMetadata()`
  Returns a description of this resource.
  `abstract Metadata`
  DataStore.`getMetadata()`
  Returns information about the data store as a whole.
  `Metadata`
  Resource.`getMetadata()`
  Returns information about this resource.
  `Optional<TreeTable>`
  DataStore.`getNativeMetadata()`
  Returns implementation-specific metadata.
  `default List<double[]>`
  GridCoverageResource.`getResolutions()`
  Returns the preferred resolutions (in units of CRS axes) for read operations in this data store.
  `List<SampleDimension>`
  GridCoverageResource.`getSampleDimensions()`
  Returns the ranges of sample values together with the conversion from samples to real values.
  `Object`
  StorageConnector.`getStorage()`
  Returns the input/output object given at construction time.
  `<S> S`
  StorageConnector.`getStorageAs(Class<S> type)`
  Returns the storage as a view of the given type if possible, or `null` otherwise.
  `DefaultFeatureType`
  FeatureSet.`getType()`
  Returns a description of properties that are common to all features in this dataset.
  `abstract DataStore`
  DataStoreProvider.`open(StorageConnector connector)`
  Creates a data store instance associated with this provider.
  `DataStore`
  DataStoreProvider.`open(ParameterValueGroup parameters)`
  Creates a data store instance associated with this provider for the given parameters.
  `static DataStore`
  DataStores.`open(Object storage)`
  Creates a `DataStore` capable to read the given storage.
  `static DataStore`
  DataStores.`open(Object storage, String preferredFormat)`
  Creates a `DataStore` capable to read the given storage, with a preference for the specified reader.
  `static DataStore`
  DataStores.`openWritable(Object storage, String preferredFormat)`
  Creates a `DataStore` capable to write or update the given storage.
  `protected void`
  FeatureQuery.`optimize(FeatureSet source)`
  Optimizes this query before execution.
  `abstract ProbeResult`
  DataStoreProvider.`probeContent(StorageConnector connector)`
  Indicates if the given storage appears to be supported by the `DataStore`s created by this provider.
  `protected <S> ProbeResult`
  DataStoreProvider.`probeContent(StorageConnector connector, Class<S> type, DataStoreProvider.Prober<? super S> prober)`
  Applies the specified test on the storage content without modifying buffer or input stream position.
  `static String`
  DataStores.`probeContentType(Object storage)`
  Returns the MIME type of the storage file format, or `null` if unknown or not applicable.
  `GridCoverage`
  GridCoverageResource.`read(GridGeometry domain, int... ranges)`
  Loads a subset of the grid coverage represented by this resource.
  `static Optional<GridCoverage>`
  DataStores.`readGridCoverage(Object storage, Envelope aoi)`
  Reads immediately the first grid coverage found in the given storage.
  `void`
  WritableAggregate.`remove(Resource resource)`
  Removes a `Resource` from this `Aggregate`.
  `void`
  WritableFeatureSet.`removeIf(Predicate<? super AbstractFeature> filter)`
  Removes all feature instances from this `FeatureSet` which matches the given predicate.
  `void`
  WritableFeatureSet.`replaceIf(Predicate<? super AbstractFeature> filter, UnaryOperator<AbstractFeature> updater)`
  Updates all feature instances from this `FeatureSet` which match the given predicate.
  `default boolean`
  GridCoverageResource.`setLoadingStrategy(RasterLoadingStrategy strategy)`
  Sets the preferred strategy about when to do the "physical" loading of raster data.
  `default FeatureSet`
  FeatureSet.`subset(Query query)`
  Requests a subset of features and/or feature properties from this resource.
  `default GridCoverageResource`
  GridCoverageResource.`subset(Query query)`
  Requests a subset of the coverage.
  `void`
  WritableFeatureSet.`updateType(DefaultFeatureType newType)`
  Declares or redefines the type of all feature instances in this feature set.
  `void`
  WritableGridCoverageResource.`write(GridCoverage coverage, WritableGridCoverageResource.Option... options)`
  Writes a new coverage in the data store for this resource.
  Constructors in org.apache.sis.storage that throw DataStoreException
  Modifier
  Constructor
  Description
  `protected`
  `DataStore(DataStoreProvider provider, StorageConnector connector)`
  Creates a new instance for the given storage (typically file or database).
  `protected`
  `DataStore(DataStore parent, DataStoreProvider provider, StorageConnector connector, boolean hidden)`
  Creates a new instance as a child of another data store instance.

- ## Uses of DataStoreException in org.apache.sis.storage.aggregate

  Methods in org.apache.sis.storage.aggregate that throw DataStoreException
  Modifier and Type
  Method
  Description
  `void`
  CoverageAggregator.`add(GridCoverageResource resource)`
  Adds the given resource.
  `void`
  CoverageAggregator.`add(GridCoverageResource resource, double lower, double span, SingleCRS crs)`
  Adds the given resource augmented with a single grid dimension.
  `void`
  CoverageAggregator.`add(GridCoverageResource resource, Instant lower, Duration span)`
  Adds the given resource augmented with a single temporal grid dimension.
  `void`
  CoverageAggregator.`add(GridCoverageResource resource, GridGeometry dimToAdd)`
  Adds the given resource augmented with the specified grid dimensions.
  `void`
  CoverageAggregator.`addAll(Stream<? extends GridCoverageResource> resources)`
  Adds all grid resources provided by the given stream.
  `void`
  CoverageAggregator.`addComponents(Aggregate resource)`
  Adds all components of the given aggregate.
  `void`
  CoverageAggregator.`addRangeAggregate(GridCoverageResource... sources)`
  Adds a resource whose range is the aggregation of the ranges of a sequence of resources.
  `void`
  CoverageAggregator.`addRangeAggregate(GridCoverageResource[] sources, int[][] bandsPerSource)`
  Adds a resource whose range is the aggregation of the specified bands of a sequence of resources.
  `static FeatureSet`
  ConcatenatedFeatureSet.`create(Collection<? extends FeatureSet> sources)`
  Creates a new feature set as a concatenation of the sequence of features given by the `sources`.
  `static FeatureSet`
  ConcatenatedFeatureSet.`create(FeatureSet... sources)`
  Creates a new feature set as a concatenation of the sequence of features given by the `sources`.
  `Stream<AbstractFeature>`
  JoinFeatureSet.`features(boolean parallel)`
  Returns a stream of all features contained in this dataset.
  `FeatureSet`
  ConcatenatedFeatureSet.`subset(Query query)`
  Requests a subset of features and/or feature properties from this resource.
  Constructors in org.apache.sis.storage.aggregate that throw DataStoreException
  Modifier
  Constructor
  Description
  `protected`
  `ConcatenatedFeatureSet(Resource parent, FeatureSet[] sources)`
  Creates a new feature set as a concatenation of the sequence of features given by the `sources`.
  ``
  `JoinFeatureSet(Resource parent, FeatureSet left, String leftAlias, FeatureSet right, String rightAlias, JoinFeatureSet.Type joinType, BinaryComparisonOperator<AbstractFeature> condition, Map<String,?> featureInfo)`
  Creates a new feature set joining the two given sets.

- ## Uses of DataStoreException in org.apache.sis.storage.geotiff

  Methods in org.apache.sis.storage.geotiff that throw DataStoreException
  Modifier and Type
  Method
  Description
  `GridCoverageResource`
  GeoTiffStore.`append(RenderedImage image, GridGeometry grid, Metadata metadata)`
  Encodes the given image in the GeoTIFF file.
  `GridCoverageResource`
  GeoTiffStore.`append(GridCoverage coverage, Metadata metadata)`
  Adds a new grid coverage in the GeoTIFF file.
  `void`
  GeoTiffStore.`close()`
  Closes this GeoTIFF store and releases any underlying resources.
  `List<GridCoverageResource>`
  GeoTiffStore.`components()`
  Returns descriptions of all images in this GeoTIFF file.
  `GridCoverageResource`
  GeoTiffStore.`findResource(String sequence)`
  Returns the image at the given index.
  `Optional<Resource.FileSet>`
  GeoTiffStore.`getFileSet()`
  Returns the paths to the files used by this GeoTIFF store.
  `Optional<GenericName>`
  GeoTiffStore.`getIdentifier()`
  Returns an identifier constructed from the name of the TIFF file.
  `Metadata`
  GeoTiffStore.`getMetadata()`
  Returns information about the dataset as a whole.
  `Optional<TreeTable>`
  GeoTiffStore.`getNativeMetadata()`
  Returns TIFF tags and GeoTIFF keys as a tree for debugging purpose.
  `DataStore`
  GeoTiffStoreProvider.`open(StorageConnector connector)`
  Creates a `GeoTiffStore` instance associated with this provider.
  `DataStore`
  GeoTiffStoreProvider.`open(ParameterValueGroup parameters)`
  Creates a `GeoTiffStore` instance from the given parameters.
  `ProbeResult`
  GeoTiffStoreProvider.`probeContent(StorageConnector connector)`
  Returns the MIME type if the given storage appears to be supported by `GeoTiffStore`.
  Constructors in org.apache.sis.storage.geotiff that throw DataStoreException
  Modifier
  Constructor
  Description
  ``
  `GeoTiffStore(DataStoreProvider provider, StorageConnector connector)`
  Creates a new GeoTIFF store from the given file, URL or stream object.
  ``
  `GeoTiffStore(DataStore parent, DataStoreProvider provider, StorageConnector connector, boolean hidden)`
  Creates a new GeoTIFF store as a component of a larger data store.

- ## Uses of DataStoreException in org.apache.sis.storage.landsat

  Methods in org.apache.sis.storage.landsat that throw DataStoreException
  Modifier and Type
  Method
  Description
  `void`
  LandsatStore.`close()`
  Closes this Landsat store and releases any underlying resources.
  `List<Aggregate>`
  LandsatStore.`components()`
  Returns the resources for each group of Landsat bands.
  `Optional<Resource.FileSet>`
  LandsatStore.`getFileSet()`
  Returns the list of band files and the `*_MTL.txt` file.
  `Optional<GenericName>`
  LandsatStore.`getIdentifier()`
  Returns the value associated to `LANDSAT_SCENE_ID` in the Landsat metadata file.
  `Metadata`
  LandsatStore.`getMetadata()`
  Returns information about the dataset as a whole.
  `DataStore`
  LandsatStoreProvider.`open(StorageConnector connector)`
  Returns a `LandsatStore` implementation associated with this provider.
  `ProbeResult`
  LandsatStoreProvider.`probeContent(StorageConnector connector)`
  Returns `ProbeResult.SUPPORTED` if the given storage appears to be supported by `LandsatStore`.
  Constructors in org.apache.sis.storage.landsat that throw DataStoreException
  Modifier
  Constructor
  Description
  ``
  `LandsatStore(DataStoreProvider provider, StorageConnector connector)`
  Creates a new Landsat store from the given file, URL, stream or character reader.

- ## Uses of DataStoreException in org.apache.sis.storage.modifier

  Methods in org.apache.sis.storage.modifier that throw DataStoreException
  Modifier and Type
  Method
  Description
  `default SampleDimension`
  CoverageModifier.`customize(CoverageModifier.BandSource source, SampleDimension.Builder dimension)`
  Invoked when a sample dimension is created in a coverage.
  `default GridGeometry`
  CoverageModifier.`customize(CoverageModifier.Source source, GridGeometry domain)`
  Invoked when a grid geometry is created for a coverage.
  `default Metadata`
  CoverageModifier.`customize(CoverageModifier.Source source, DefaultMetadata metadata)`
  Invoked when a metadata is created for a single coverage or for the whole file.
  `default GenericName`
  CoverageModifier.`customize(CoverageModifier.Source source, GenericName identifier)`
  Invoked when an identifier is created for a single coverage or for the whole file.
  `default boolean`
  CoverageModifier.`isElectromagneticMeasurement(CoverageModifier.Source source)`
  Returns `true` if the converted values are measurement in the electromagnetic spectrum.

- ## Uses of DataStoreException in org.apache.sis.storage.netcdf

  Methods in org.apache.sis.storage.netcdf that throw DataStoreException
  Modifier and Type
  Method
  Description
  `void`
  NetcdfStore.`close()`
  Closes this netCDF store and releases any underlying resources.
  `Collection<Resource>`
  NetcdfStore.`components()`
  Returns the resources (features or coverages) in this netCDF store.
  `Version`
  NetcdfStore.`getConventionVersion()`
  Returns the version number of the Climate and Forecast (CF) conventions used in the netCDF file.
  `Optional<GenericName>`
  NetcdfStore.`getIdentifier()`
  Returns an identifier constructed from global attributes or the filename of the netCDF file.
  `Metadata`
  NetcdfStore.`getMetadata()`
  Returns information about the dataset as a whole.
  `Optional<TreeTable>`
  NetcdfStore.`getNativeMetadata()`
  Returns netCDF attributes.
  `DataStore`
  NetcdfStoreProvider.`open(StorageConnector connector)`
  Returns a `NetcdfStore` implementation associated with this provider.
  `ProbeResult`
  NetcdfStoreProvider.`probeContent(StorageConnector connector)`
  Returns the MIME type if the given storage appears to be supported by `NetcdfStore`.
  Constructors in org.apache.sis.storage.netcdf that throw DataStoreException
  Modifier
  Constructor
  Description
  ``
  `NetcdfStore(DataStoreProvider provider, StorageConnector connector)`
  Creates a new netCDF store from the given file, URL, stream or `NetcdfFile` object.

- ## Uses of DataStoreException in org.apache.sis.storage.sql

  Methods in org.apache.sis.storage.sql that throw DataStoreException
  Modifier and Type
  Method
  Description
  `void`
  SQLStore.`close()`
  Closes this SQL store and releases any underlying resources.
  `Collection<FeatureSet>`
  SimpleFeatureStore.`components()`
  Returns the tables (feature sets) in this SQL store.
  `Collection<? extends Resource>`
  SQLStore.`components()`
  Returns the resources (feature set or coverages) in this SQL store.
  `CoordinateReferenceSystem`
  DataAccess.`findCRS(int srid)`
  Returns the coordinate reference system associated to the given identifier.
  `FeatureSet`
  SimpleFeatureStore.`findResource(String identifier)`
  Searches for a resource identified by the given identifier.
  `Resource`
  SQLStore.`findResource(String identifier)`
  Searches for a resource identified by the given identifier.
  `int`
  DataAccess.`findSRID(CoordinateReferenceSystem crs)`
  Returns the SRID associated to the given spatial reference system.
  `Map<String,Version>`
  SQLStore.`getDatabaseSoftwareVersions()`
  Returns the version of the database software, together with versions of extensions if any.
  `Optional<GenericName>`
  SQLStore.`getIdentifier()`
  Returns an identifier for the root resource of this SQL store, or an empty value if none.
  `Metadata`
  SQLStore.`getMetadata()`
  Returns information about the dataset as a whole.
  `protected void`
  SQLStore.`initialize(Connection connection)`
  Invoked the first time that `SQLStore` opens a connection on the database, or after refresh.
  `DataStore`
  SQLStoreProvider.`open(StorageConnector connector)`
  Returns a `SQLStore` implementation associated with this provider.
  `DataStore`
  SQLStoreProvider.`open(ParameterValueGroup parameters)`
  Returns a data store implementation associated with this provider for the given parameters.
  `ProbeResult`
  SQLStoreProvider.`probeContent(StorageConnector connector)`
  Returns `ProbeResult.SUPPORTED` if the given storage appears to be supported by `SQLStore`.
  `protected abstract ResourceDefinition[]`
  SQLStore.`readResourceDefinitions(DataAccess dao)`
  A callback for providing the resource definitions of a database, typically from a content table.
  `void`
  SQLStore.`vacuum()`
  Executes the `"VACUUM"` statement on the database.
  Constructors in org.apache.sis.storage.sql that throw DataStoreException
  Modifier
  Constructor
  Description
  ``
  `SimpleFeatureStore(DataStoreProvider provider, StorageConnector connector, ResourceDefinition... resources)`
  Creates a new `SimpleFeatureStore` for the given data source and tables, views or queries.
  `protected`
  `SQLStore(DataStoreProvider provider, StorageConnector connector)`
  Creates a new `SQLStore` for the given data source.

- ## Uses of DataStoreException in org.apache.sis.storage.tiling

  Methods in org.apache.sis.storage.tiling that throw DataStoreException
  Modifier and Type
  Method
  Description
  `WritableTileMatrix`
  WritableTileMatrixSet.`createTileMatrix(TileMatrix tiles)`
  Adds the given tile matrix to this set and returns a writable instance for later completion.
  `WritableTileMatrixSet`
  WritableTiledResource.`createTileMatrixSet(TileMatrixSet tiles)`
  Adds the given tile matrix set to this resource and returns a writable instance for later completion.
  `void`
  WritableTileMatrixSet.`deleteTileMatrix(String identifier)`
  Deletes a `TileMatrix` identified by the given name.
  `void`
  WritableTiledResource.`deleteTileMatrixSet(String identifier)`
  Deletes a `TileMatrixSet` identified by the given name.
  `long`
  WritableTileMatrix.`deleteTiles(GridExtent indicesRanges)`
  Deletes all existing tiles in the given region.
  `default Optional<Path>`
  Tile.`getContentPath()`
  Returns a path to the tile content as a file or a BLOB.
  `Resource`
  Tile.`getResource()`
  Returns the tile content as a resource.
  `Optional<Tile>`
  TileMatrix.`getTile(long... indices)`
  Gets a tile at the given indices.
  `Collection<? extends TileMatrixSet>`
  TiledResource.`getTileMatrixSets()`
  Returns the collection of all available tile matrix sets in this resource.
  `Collection<? extends WritableTileMatrixSet>`
  WritableTiledResource.`getTileMatrixSets()`
  Returns the collection of all available tile matrix sets in this resource.
  `Stream<Tile>`
  TileMatrix.`getTiles(GridExtent indicesRanges, boolean parallel)`
  Retrieves a stream of existing tiles in the specified region.
  `TileStatus`
  TileMatrix.`getTileStatus(long... indices)`
  Fetches information about whether a tile exists, is missing or failed to load.
  `void`
  WritableTileMatrix.`writeTiles(Stream<Tile> tiles)`
  Writes a stream of tiles.