.ipynb

Spherical Harmonic (SPHARM) Analysis#

import numpy as np

import plotly.graph_objects as go

import vtk
from vtk.numpy_interface import dataset_adapter as dsa

from ktch.harmonic import SphericalHarmonicAnalysis, xyz2spherical
from ktch.datasets import fetch

Load 3D potato surface data#

# parameter mesh
para_path = fetch("danshaku_08_allSegments_para.vtp")
print(para_path)

reader = vtk.vtkXMLPolyDataReader()
reader.SetFileName(para_path)
reader.Update()
obj_para = dsa.WrapDataObject(reader.GetOutput())

# surface mesh
surf_path = fetch("danshaku_08_allSegments_surf.vtp")
print(surf_path)

reader = vtk.vtkXMLPolyDataReader()
reader.SetFileName(surf_path)
reader.Update()
obj_surf = dsa.WrapDataObject(reader.GetOutput())
Downloading data from 'https://pub-c1d6dba6c94843f88f0fd096d19c0831.r2.dev/examples/danshaku_08_allSegments_para/v1/danshaku_08_allSegments_para.vtp' to file '/home/runner/.cache/ktch-examples/danshaku_08_allSegments_para/v1/danshaku_08_allSegments_para.vtp'.
Downloading data from 'https://pub-c1d6dba6c94843f88f0fd096d19c0831.r2.dev/examples/danshaku_08_allSegments_surf/v1/danshaku_08_allSegments_surf.vtp' to file '/home/runner/.cache/ktch-examples/danshaku_08_allSegments_surf/v1/danshaku_08_allSegments_surf.vtp'.
/home/runner/.cache/ktch-examples/danshaku_08_allSegments_para/v1/danshaku_08_allSegments_para.vtp
/home/runner/.cache/ktch-examples/danshaku_08_allSegments_surf/v1/danshaku_08_allSegments_surf.vtp
arr_para_faces = np.array(obj_para.Polygons.reshape(-1, 4)[:, 1:])
arr_para = np.array(obj_para.Points)

arr_surf_faces = np.array(obj_surf.Polygons.reshape(-1, 4)[:, 1:])
arr_surf = np.array(obj_surf.Points)

Parameter mesh#

I, J, K = arr_para_faces.T
x_surf, y_surf, z_surf = arr_para.T

fig = go.Figure(
    data=[
        go.Mesh3d(
            x=x_surf,
            y=y_surf,
            z=z_surf,
            i=I,
            j=J,
            k=K,
            opacity=0.3,
            showscale=False,
        ),
    ]
)

fig.update_layout(
    width=700,
    height=700,
    autosize=False,
    scene=dict(
        camera=dict(
            up=dict(x=0, y=0, z=1),
            eye=dict(
                x=1.1,
                y=1.1,
                z=1.1,
            ),
        ),
        aspectmode="data",
    ),
)

fig.show()

Surface mesh#

I, J, K = arr_surf_faces.T
x_surf, y_surf, z_surf = arr_surf.T

fig = go.Figure(
    data=[
        go.Mesh3d(
            x=x_surf,
            y=y_surf,
            z=z_surf,
            i=I,
            j=J,
            k=K,
            opacity=0.3,
            showscale=False,
        ),
    ]
)

fig.update_layout(
    width=700,
    height=700,
    autosize=False,
    scene=dict(
        camera=dict(
            up=dict(x=0, y=0, z=1),
            eye=dict(
                x=1.1,
                y=1.1,
                z=1.1,
            ),
        ),
        aspectmode="data",
    ),
)

fig.show()

SPHARM Analysis#

# registration=None keeps raw coefficients for overlaying the original
spharm_analysis = SphericalHarmonicAnalysis(n_harmonics=10, registration=None)
X_transform = spharm_analysis.fit_transform([arr_surf], theta_phi=[xyz2spherical(arr_para)])
X_transform
array([[-2.29719996e-02,  2.48897299e-03,  1.10721103e-02,
         6.58749773e-02, -1.88412738e-03, -9.04224884e-04,
        -2.13760644e-04, -3.48942630e-03,  1.14882027e-03,
         8.96017675e-04,  7.86471284e-04, -4.42645011e-04,
        -3.46744637e-04,  3.24926135e-04,  9.91263753e-04,
        -1.96090302e-04, -7.51414534e-04, -2.44784707e-04,
         4.44948450e-04, -1.12307151e-04,  2.26480784e-04,
         5.49308069e-04, -5.92965242e-04, -3.68910030e-04,
        -7.16185083e-04,  2.02577088e-04, -6.69970177e-04,
        -1.32381302e-05,  1.73828539e-04, -9.36412999e-05,
        -2.94812660e-04,  1.03155856e-03,  2.63623447e-04,
        -5.80006288e-04,  1.01434664e-04, -8.53462154e-05,
         3.10547547e-05,  1.14528716e-04,  5.37492368e-04,
        -9.91806773e-06,  2.00438750e-04,  8.49202154e-05,
         4.95628895e-05,  3.85075487e-04,  7.98211584e-06,
         2.56847912e-04,  8.43456143e-06, -6.29501121e-04,
        -3.00995433e-04,  7.15586756e-05, -1.84408115e-04,
        -6.79018378e-05,  4.82501755e-05,  1.04726411e-06,
         4.32939966e-05,  1.01194945e-04,  3.30879830e-06,
        -1.10895276e-04, -5.50607617e-06,  2.64687819e-04,
        -1.07519784e-04, -4.30962530e-04, -2.90264829e-05,
         5.10075380e-05, -9.54235149e-05, -3.00743261e-05,
        -1.92703528e-04, -1.39380614e-04,  1.70239181e-04,
         1.55171259e-04, -2.37208868e-05,  4.18032864e-05,
        -3.38266988e-05, -1.47348539e-04, -1.98610751e-05,
         7.05419334e-05,  1.60770542e-05, -2.90684148e-05,
         5.63951735e-05,  1.26833458e-04, -1.32168845e-06,
         1.41824072e-04,  5.59827480e-05,  3.07816326e-06,
         1.09042363e-04, -8.76469805e-06, -1.32338593e-05,
         2.44472029e-05, -3.15469842e-05, -9.82082999e-08,
        -9.65559405e-05,  5.18043316e-05,  4.19001007e-05,
        -1.26956018e-04,  6.35386203e-05,  1.08406746e-04,
        -8.52131836e-05, -1.00843505e-04, -1.27415109e-04,
        -2.72490080e-05, -8.18068437e-05, -2.18691940e-05,
        -1.80776960e-05, -7.16986207e-05, -7.77004539e-05,
         4.37230704e-05, -5.84897965e-05, -1.86098332e-05,
        -2.87966218e-05, -2.25188906e-05, -6.33736662e-05,
         1.65206233e-04,  2.65670537e-05, -6.58326909e-05,
         6.82958247e-05,  2.07533845e-05, -1.14730906e-04,
        -1.78374975e-05,  2.24814938e-05, -1.72531044e-05,
        -5.68174464e-05,  1.20166973e-01, -4.57018857e-02,
        -2.92836034e-02, -1.78043165e-03,  2.08950065e-04,
         1.17996679e-03,  4.58999997e-04,  6.39359971e-05,
         1.08406676e-03, -2.43563522e-03,  6.71051122e-05,
        -6.00421583e-04,  6.45702938e-05,  8.20336373e-05,
         3.22800102e-04,  4.98165486e-04, -1.26058503e-03,
        -1.02549123e-03,  1.29035014e-04, -1.08431595e-04,
         8.58986943e-05,  2.80544211e-04, -5.41581488e-04,
        -4.04062284e-04, -5.52273221e-04,  2.07193392e-04,
        -5.98607902e-04, -7.48400413e-04, -2.41370466e-04,
        -1.10436503e-04, -7.51987747e-07,  1.38446257e-04,
        -4.02500948e-04, -3.91873117e-04,  3.25145515e-04,
         2.61207875e-04,  2.90792085e-04,  6.13732543e-04,
         4.02344198e-04, -3.18754669e-04,  1.88885016e-05,
        -5.38618916e-04,  1.61558962e-04, -1.07760746e-04,
        -2.59938615e-04, -2.28924938e-05,  3.48788520e-04,
         8.19309604e-06, -9.31133395e-06, -1.06410771e-04,
        -5.04273472e-05,  3.47659415e-04, -2.84962841e-05,
        -1.59915222e-05,  1.76309130e-04, -2.37360867e-04,
         4.02440729e-05, -1.45095584e-04, -9.18538199e-05,
        -1.03949502e-04,  1.21149968e-04,  1.97081879e-04,
        -1.18255338e-04, -6.77488456e-05, -7.69816064e-05,
         5.34472586e-05,  2.21896216e-04,  3.02360148e-05,
        -4.62162314e-05,  5.17774015e-05, -2.07755506e-05,
         3.16723009e-05,  3.91490777e-05, -7.92974927e-05,
         2.26871903e-04, -1.71638326e-05,  1.86382953e-04,
         2.33975392e-04,  2.41957899e-04, -8.93480944e-05,
        -8.02987493e-05,  1.01039397e-04, -1.35621483e-04,
         1.13118518e-05,  7.80794687e-05, -7.84752228e-06,
        -6.50121026e-05,  9.39320708e-05,  3.58260511e-06,
        -3.36765006e-06, -1.16021144e-04,  1.09754087e-04,
         5.83097366e-05,  7.76716147e-08,  2.95108397e-05,
         1.66244330e-04, -1.59354941e-04, -2.87446659e-04,
         1.87457305e-05,  2.14879332e-04, -4.45391372e-05,
        -1.62336395e-06, -7.54173020e-05, -1.76685993e-04,
         2.70132703e-05, -6.85878640e-05, -1.98474916e-05,
        -2.33349576e-05, -9.86704357e-06, -4.99730810e-05,
        -3.00361050e-05, -1.51402471e-05, -1.26093896e-05,
         3.11205434e-05, -1.04432283e-05,  1.86333031e-05,
        -1.26776827e-04, -9.79741037e-05,  4.12408627e-05,
        -1.98547513e-06, -7.91947553e-05, -1.15047627e+00,
         1.48890458e-02, -4.76763228e-02,  1.90055413e-03,
        -3.25403256e-05, -1.71732232e-03, -2.83188315e-03,
         3.97349550e-05, -9.23357408e-04,  1.16393955e-03,
         2.99497107e-04, -2.07685054e-03, -1.95999305e-03,
        -1.79953929e-03, -1.66321351e-03,  7.48337815e-05,
         4.61072309e-04,  2.51663402e-04,  4.04768279e-04,
         2.05541410e-05, -1.23425201e-03,  2.33905729e-04,
         1.59711576e-04, -8.63768692e-05,  7.56225181e-04,
        -1.16425633e-04,  3.57393996e-05, -8.97827595e-05,
         2.08667650e-04,  2.49988816e-04, -2.23307368e-04,
         4.02295701e-04, -2.86372450e-05, -2.39005395e-04,
         3.29830489e-04,  8.69183370e-05, -2.99696062e-04,
        -2.31110708e-04, -1.28784834e-04, -4.85688388e-04,
        -7.46370073e-05,  7.29466347e-05,  4.07137668e-05,
        -1.79749794e-04, -4.04248281e-04,  8.70210060e-05,
         2.54031003e-04,  1.97306837e-04, -1.82018574e-04,
         1.45122789e-04, -1.31215278e-05, -4.43415489e-05,
        -1.98245828e-04, -7.64531532e-05, -1.27541243e-04,
         1.71050262e-04,  1.05310824e-04,  5.84795315e-05,
        -1.26664169e-04,  6.20618044e-05,  1.79014004e-04,
        -1.06013618e-04,  1.29491531e-04,  5.15163727e-05,
         1.67680017e-05,  3.95247873e-05,  1.85547106e-04,
        -1.89266874e-05, -1.34466364e-05, -1.37260830e-04,
        -5.84829265e-05, -2.40627095e-04,  3.29447035e-06,
        -6.93284925e-05,  1.20621542e-04, -9.37506187e-05,
        -1.87627944e-04,  3.80125655e-05, -7.76576849e-05,
         5.22594171e-06,  4.15875288e-05, -6.35005105e-05,
        -1.06864027e-04, -8.62110166e-05,  1.62823816e-04,
         1.84039454e-04, -1.67959312e-05,  7.14661703e-06,
         9.98705841e-06, -6.99499802e-05, -1.04087596e-04,
         1.60688139e-05,  2.56547305e-04, -1.29621200e-04,
        -2.21146531e-04,  2.63751981e-05, -2.88686734e-05,
         1.06602000e-04,  6.10283713e-05, -7.49352671e-05,
         3.81498118e-05,  2.47948024e-05,  5.01497937e-05,
         4.89607330e-05,  8.87420495e-05,  8.50700305e-05,
        -5.30953857e-05,  1.41718334e-04,  5.90517793e-05,
         7.53406209e-05, -4.48072337e-05, -4.42725361e-05,
         1.17121900e-04,  1.63044825e-05, -2.05474849e-05,
        -8.24988032e-05, -6.62420390e-05,  3.30957060e-05,
         9.80959375e-05,  6.17558447e-05,  4.57492272e-05]])

Inverse analysis#

Reconstruct 3D surface shapes from SPHARM coefficients.

X_coords = spharm_analysis.inverse_transform(X_transform.reshape(1, 3, -1))
x_sph, y_sph, z_sph = X_coords[0].T

fig = go.Figure(
    data=[
        go.Surface(
            x=x_sph,
            y=y_sph,
            z=z_sph,
            opacity=0.3,
            showscale=False,
        ),
    ]
)

fig.update_layout(
    width=700,
    height=700,
    autosize=False,
    scene=dict(
        camera=dict(
            up=dict(x=0, y=0, z=1),
            eye=dict(
                x=1.1,
                y=1.1,
                z=1.1,
            ),
        ),
        aspectmode="data",
    ),
)

fig.show()

Original vs reconstructed shapes#

Overlay the original and reconstructed surface data. This demonstrates that the original shape is well reproduced.

I, J, K = arr_surf_faces.T
x_surf, y_surf, z_surf = arr_surf.T

x_sph, y_sph, z_sph = X_coords[0].T


fig = go.Figure(
    data=[
        go.Mesh3d(
            x=x_surf,
            y=y_surf,
            z=z_surf,
            i=I,
            j=J,
            k=K,
            opacity=0.8,
            showscale=False,
        ),
        go.Surface(
            x=x_sph,
            y=y_sph,
            z=z_sph,
            opacity=0.4,
            showscale=False,
        ),
    ]
)

fig.update_layout(
    width=700,
    height=700,
    autosize=False,
    scene=dict(
        camera=dict(
            up=dict(x=0, y=0, z=1),
            eye=dict(
                x=1.1,
                y=1.1,
                z=1.1,
            ),
        ),
        aspectmode="data",
    ),
)

fig.show()