Skip to content

liblaf.melon.cli

Command-line interface entry points.

Functions:

Attributes:

  • app (App) –

app module-attribute 

app: App = App('melon', version=_get_version)

annotate_landmarks 

annotate_landmarks(
    left_path: Annotated[Path, Parameter(left)],
    right_path: Annotated[Path, Parameter(right)],
    /,
    *,
    left_landmarks_path: Annotated[
        Path | None, Parameter(left - landmarks)
    ] = None,
    right_landmarks_path: Annotated[
        Path | None, Parameter(right - landmarks)
    ] = None,
) -> None

Annotate corresponding landmarks for two mesh files.

Parameters:

  • left_path (Annotated[Path, Parameter(left)]) –

    Left mesh path.

  • right_path (Annotated[Path, Parameter(right)]) –

    Right mesh path.

  • left_landmarks_path (Annotated[Path | None, Parameter(left - landmarks)], default: None ) –

    Optional explicit sidecar path for left landmarks.

  • right_landmarks_path (Annotated[Path | None, Parameter(right - landmarks)], default: None ) –

    Optional explicit sidecar path for right landmarks.

Source code in src/liblaf/melon/cli/_annotate_landmarks.py 
12
13
14
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
def annotate_landmarks(
    left_path: Annotated[Path, Parameter("left")],
    right_path: Annotated[Path, Parameter("right")],
    /,
    *,
    left_landmarks_path: Annotated[Path | None, Parameter("left-landmarks")] = None,
    right_landmarks_path: Annotated[Path | None, Parameter("right-landmarks")] = None,
) -> None:
    """Annotate corresponding landmarks for two mesh files.

    Args:
        left_path: Left mesh path.
        right_path: Right mesh path.
        left_landmarks_path: Optional explicit sidecar path for left landmarks.
        right_landmarks_path: Optional explicit sidecar path for right landmarks.
    """
    if left_landmarks_path is None:
        left_landmarks_path: Path = left_path
    if right_landmarks_path is None:
        right_landmarks_path: Path = right_path
    left: pv.PolyData = io.load_polydata(left_path)
    left_landmarks: Float[np.ndarray, "landmarks 3"] = io.load_landmarks(
        left_landmarks_path
    )
    right: pv.PolyData = io.load_polydata(right_path)
    right_landmarks: Float[np.ndarray, "landmarks 3"] = io.load_landmarks(
        right_landmarks_path
    )
    left_landmarks, right_landmarks = ext.annotate_landmarks(
        left, right, left_landmarks=left_landmarks, right_landmarks=right_landmarks
    )
    io.save_landmarks(left_landmarks, left_landmarks_path)
    io.save_landmarks(right_landmarks, right_landmarks_path)