TopoStats Modules

For decoding and loading .topostats (HDF5 format) AFM file format into Python Nympy arrays.

load_topostats(file_path)

Extract image and pixel to nm scaling from the .topostats (HDF5 format) file.

Parameters:

Name Type Description Default
file_path Path or str

Path to the .topostats file.

 required

Returns:

Type Description
dict[str, Any]

A dictionary containing the image, its pixel to nm scaling factor and nested Numpy arrays representing the analyses performed on the data.

Raises:

Type Description
OSError

If the file is not found.

Examples:

>>> image, pixel_to_nm_scaling = load_topostats("path/to/topostats_file.topostats")
Source code in AFMReader/topostats.py 
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
def load_topostats(file_path: Path | str) -> dict[str, Any]:
    """
    Extract image and pixel to nm scaling from the .topostats (HDF5 format) file.

    Parameters
    ----------
    file_path : Path or str
        Path to the .topostats file.

    Returns
    -------
    dict[str, Any]
        A dictionary containing the image, its pixel to nm scaling factor and nested Numpy arrays representing the
        analyses performed on the data.

    Raises
    ------
    OSError
        If the file is not found.

    Examples
    --------
    >>> image, pixel_to_nm_scaling = load_topostats("path/to/topostats_file.topostats")
    """
    logger.info(f"Loading image from : {file_path}")
    file_path = Path(file_path)
    filename = file_path.stem
    try:
        with h5py.File(file_path, "r") as f:
            data = unpack_hdf5(open_hdf5_file=f, group_path="/")
            if data["topostats_file_version"] >= 0.2:
                data["img_path"] = Path(data["img_path"])
            file_version = data["topostats_file_version"]
            logger.info(f"[{filename}] TopoStats file version : {file_version}")

    except OSError as e:
        if "Unable to open file" in str(e):
            logger.error(f"[{filename}] File not found : {file_path}")
        raise e

    return data