A ScoreTiler is basically a GridTiler (because it extracts all the tiles following a grid structure), but it saves only the first n_tiles with the highest score, according to a scoring function. If n_tiles is equal to 0, it saves all the tiles (exact same behavior as a GridTiler)

Scorer

The scoring functions are implemented in the scorer module. All the scorers are classes with a __call__ method, which takes as parameter a Tile object and returns a float. These characteristics are implemented in the Scorer protocol. At the moment there is only a RandomScorer, which returns a random number between 0 and 1, not considering the tile, but it serves as an initial example.

Example

from histolab.scorer import RandomScorer
from histolab.tile import Tile

random_scorer = RandomScorer()
tile = Tile(img, coords, level)
score = random_scorer(tile)

ScoreTiler

The ScoreTiler (other than the parameters required by a GridTiler) needs a scoring function (which implements the Scoring protocol).

Example

# following from the previous example

from histolab.tiler import ScoreTiler
from histolab.slide import Slide

slide = Slide("path/to/slide", "path/to/processed")
score_tiler = ScoreTiler(random_scorer, tile_size=(512,512), n_tiles=2, level=0, ...)
score_tiler.extract(slide)