import_landmark_files¶
-
menpo.io.
import_landmark_files
(pattern, max_landmarks=None, shuffle=False, as_generator=False, verbose=False)[source]¶ Import Multiple landmark files.
For each landmark file found returns an importer then returns a
LabelledPointUndirectedGraph
or aPointCloud
.Note that this is a function returns a
LazyList
. Therefore, the function will return immediately and indexing into the returned list will load the landmarks at run time. If all landmarks should be loaded, then simply wrap the returnedLazyList
in a Python list.- Parameters
pattern (str) – A glob path pattern to search for landmark files. Every landmark file found to match the glob will be imported one by one. See
landmark_file_paths
for more details of what landmark files will be found.max_landmarks (positive int, optional) – If not
None
, only import the firstmax_landmark_files
found. Else, import all.shuffle (bool, optional) – If
True
, the order of the returned landmark files will be randomised. IfFalse
, the order of the returned landmark files will be alphanumerically ordered.as_generator (bool, optional) – If
True
, the function returns a generator and assets will be yielded one after another when the generator is iterated over.verbose (bool, optional) – If
True
progress of the importing will be dynamically reported.
- Returns
lazy_list (
LazyList
or generator) – ALazyList
or generator yieldingPointCloud
orLabelledPointUndirectedGraph
instances found to match the glob pattern provided.- Raises
ValueError – If no landmarks are found at the provided glob.