The data IO module
Utilities related to data reading, writing, fetching, and generation.
-
vispy.io.imread(filename, format=None)[source]
Read image data from disk
Requires imageio or PIL.
| Parameters: | filename : str
format : str | None
Format of the file. If None, it will be inferred from the filename.
|
|---|
| Returns: | data : array
|
|---|
-
vispy.io.imsave(filename, im, format=None)[source]
Save image data to disk
Requires imageio or PIL.
| Parameters: | filename : str
im : array
format : str | None
Format of the file. If None, it will be inferred from the filename.
|
|---|
-
vispy.io.load_iris()[source]
Load the iris dataset
| Returns: | iris : NpzFile
data[‘data’] : a (150, 4) NumPy array with the iris’ features
data[‘group’] : a (150,) NumPy array with the iris’ group
|
|---|
-
vispy.io.load_crate()[source]
Load an image of a crate
-
vispy.io.load_spatial_filters(packed=True)[source]
Load spatial-filters kernel
| Parameters: | packed : bool
Whether or not the data should be in “packed” representation
for use in GLSL code.
|
|---|
| Returns: | kernel : array
16x1024x4 (packed float in rgba) or
16x1024 (unpacked float)
16 interpolation kernel with length 1024 each.
names : tuple of strings
Respective interpolation names, plus “Nearest” which does
not require a filter but can still be used
|
|---|
-
vispy.io.load_data_file(fname, directory=None, force_download=False)[source]
Get a standard vispy demo data file
| Parameters: | fname : str
The filename on the remote demo-data repository to download,
e.g. 'molecular_viewer/micelle.npy'. These correspond to paths
on https://github.com/vispy/demo-data/.
directory : str | None
Directory to use to save the file. By default, the vispy
configuration directory is used.
force_download : bool | str
If True, the file will be downloaded even if a local copy exists
(and this copy will be overwritten). Can also be a YYYY-MM-DD date
to ensure a file is up-to-date (modified date of a file on disk,
if present, is checked).
|
|---|
| Returns: | fname : str
The path to the file on the local system.
|
|---|
-
vispy.io.read_mesh(fname)[source]
Read mesh data from file.
| Parameters: | fname : str
File name to read. Format will be inferred from the filename.
Currently only ‘.obj’ and ‘.obj.gz’ are supported.
|
|---|
| Returns: | vertices : array
faces : array | None
Triangle face definitions.
normals : array
texcoords : array | None
|
|---|
-
vispy.io.read_png(filename)[source]
Read a PNG file to RGB8 or RGBA8
Unlike imread, this requires no external dependencies.
| Parameters: | filename : str
|
|---|
| Returns: | data : array
|
|---|
-
vispy.io.write_mesh(fname, vertices, faces, normals, texcoords, name='', format='obj', overwrite=False, reshape_faces=True)[source]
Write mesh data to file.
| Parameters: | fname : str
Filename to write. Must end with “.obj” or “.gz”.
vertices : array
faces : array | None
Triangle face definitions.
normals : array
texcoords : array | None
name : str
format : str
Currently only “obj” is supported.
overwrite : bool
If the file exists, overwrite it.
reshape_faces : bool
Reshape the faces array to (Nf, 3). Set to False
if you need to write a mesh with non triangular faces.
|
|---|
-
vispy.io.write_png(filename, data)[source]
Write a PNG file
Unlike imsave, this requires no external dependencies.
| Parameters: | filename : str
data : array
|
|---|
0.6