105 lines
7.3 KiB
Markdown
105 lines
7.3 KiB
Markdown
# Gwyddion Features Not Yet in tono
|
|
|
|
Reference for future implementation. Grouped by value to typical SPM workflows.
|
|
|
|
---
|
|
|
|
## High Value
|
|
|
|
| # | Feature | Gwyddion Source | Description |
|
|
|---|---------|---------------|-------------|
|
|
| ~~1~~ | ~~Line Correction~~ | ~~linecorrect.c, linematch.c~~ | ~~Row-by-row median/polynomial alignment. Essential for raw SPM data with scan-line artifacts.~~ **DONE** |
|
|
| ~~2~~ | ~~Scar Removal~~ | ~~scars.c~~ | ~~Detect and interpolate scan-line defects (horizontal streaks).~~ **DONE** |
|
|
| ~~3~~ | ~~Facet Leveling~~ | ~~facet-level.c~~ | ~~Orient the dominant surface facet to horizontal. Better than plane level for terraced/stepped surfaces.~~ **DONE** |
|
|
| ~~4~~ | ~~Morphological Mask Ops~~ | ~~mask_morph.c~~ | ~~Erode, dilate, open, close on grain masks. Needed to clean up thresholded masks.~~ **DONE** |
|
|
| ~~5~~ | ~~1D FFT Filter~~ | ~~fft_filter_1d.c~~ | ~~Bandpass/lowpass/highpass filtering of LINE profiles.~~ **DONE** |
|
|
| ~~6~~ | ~~2D FFT Filter~~ | ~~fft_filter_2d.c~~ | ~~Frequency-domain filtering of DATA_FIELDs (remove periodic noise, etc.).~~ **DONE** |
|
|
| ~~7~~ | ~~Autocorrelation (ACF)~~ | ~~acf2d.c~~ | ~~2D autocorrelation function. Reveals periodic structures and correlation lengths.~~ **DONE** |
|
|
| ~~8~~ | ~~PSDF~~ | ~~psdf2d.c~~ | ~~Radial/2D power spectral density function. Complementary to ACF for roughness characterization.~~ **DONE** |
|
|
| ~~9~~ | ~~Fractal Dimension~~ | ~~fractal.c~~ | ~~Multiple methods: partitioning, cube counting, triangulation, PSDF, HHCF. Quantifies surface complexity.~~ **DONE** |
|
|
| ~~10~~ | ~~Curvature~~ | ~~curvature.c~~ | ~~Quadratic-surface curvature fit with principal radii/directions. Useful for apex and dome characterization.~~ **DONE** |
|
|
| ~~11~~ | ~~Grain Distance Transform~~ | ~~mask_edt.c~~ | ~~Euclidean distance from grain boundaries. Useful for spatial distribution analysis.~~ **DONE** |
|
|
| ~~12~~ | ~~Watershed Segmentation~~ | ~~grain_wshed.c~~ | ~~Automatic grain detection without manual threshold. More robust than simple thresholding.~~ **DONE** |
|
|
| ~~13~~ | ~~Rotate / Flip~~ | ~~rotate.c, basicops.c~~ | ~~Basic geometric transforms (90°, arbitrary angle, mirror).~~ **DONE** |
|
|
| ~~14~~ | ~~Crop~~ | ~~crop.c~~ | ~~Extract sub-region of a field.~~ **DONE** |
|
|
|
|
## Medium Value
|
|
|
|
| # | Feature | Gwyddion Source | Description |
|
|
|---|---------|---------------|-------------|
|
|
| 15 | Correlation / Pattern Matching | crosscor.c, maskcor.c | Find repeated features or align images via cross-correlation. |
|
|
| ~~16~~ | ~~Slope Distribution~~ | ~~slope_dist.c~~ | ~~Angular histogram of surface slopes. Characterizes surface texture directionality.~~ **DONE** |
|
|
| ~~17~~ | ~~Grain Filtering~~ | ~~grain_filter.c~~ | ~~Remove grains by size, height, or border contact. Refine grain masks post-detection.~~ **DONE** |
|
|
| ~~18~~ | ~~Field Arithmetic~~ | ~~arithmetic.c~~ | ~~Add/subtract/multiply/divide two DATA_FIELDs. Useful for difference maps, normalization.~~ **DONE** |
|
|
| 19 | Spot Removal | spotremove.c | Interpolate over selected point defects (dust, spikes). |
|
|
| ~~20~~ | ~~Tip Modeling / Deconvolution~~ | ~~tip_blind.c, tip_model.c~~ | ~~Estimate tip shape from image, deconvolve to recover true surface.~~ **DONE** |
|
|
| ~~21~~ | ~~Radial Profile~~ | ~~rprofile tool~~ | ~~Azimuthally averaged profile from a center point. Good for circular features.~~ **DONE** |
|
|
| 22 | Wavelet Transform | dwt.c, cwt.c | Discrete/continuous wavelet analysis. Multi-scale roughness decomposition. |
|
|
| ~~23~~ | ~~Scale / Resample~~ | ~~scale.c, resample.c~~ | ~~Resize fields with interpolation.~~ **DONE** |
|
|
| ~~24~~ | ~~Gradient~~ | ~~gradient.c~~ | ~~Compute x/y gradient magnitude maps.~~ **DONE** |
|
|
| 25 | Custom Convolution | convolution_filter.c | User-defined kernel convolution. |
|
|
| 26 | Local Contrast Enhancement | local_contrast.c | Enhance visibility of local features in images. |
|
|
|
|
## Lower Priority
|
|
|
|
| # | Feature | Gwyddion Source | Description |
|
|
|---|---------|---------------|-------------|
|
|
| 27 | Drift Correction | drift.c | Compensate for thermal/piezo drift between scan lines. |
|
|
| 28 | Affine / Perspective Correction | correct_affine.c, correct_perspective.c | Fix geometric distortions from scanner nonlinearity. |
|
|
| 29 | MFM Analysis | mfm_*.c | Magnetic force microscopy: field calculation, shift finding. |
|
|
| 30 | Lattice Measurement | measure_lattice.c | Detect and measure periodic lattice structures from ACF/FFT. |
|
|
| 31 | Hough Transform | hough.c | Detect lines and circles in images. |
|
|
| 32 | Image Stitching / Merging | merge.c, stitch.c | Combine multiple overlapping scans into one image. |
|
|
| 33 | Facet Analysis | facet_analysis.c | Orientation distribution of surface facets (stereographic projection). |
|
|
| 34 | Shape Fitting | fit-shape.c | Fit geometric primitives: sphere, paraboloid, cylinder, etc. |
|
|
| 35 | Synthetic Surface Generation | *_synth.c (~20 modules) | Generate test surfaces: FBM, noise, lattice, waves, particles, fibers, etc. |
|
|
| 36 | Entropy | entropy.c | Information entropy of height distribution. |
|
|
| 37 | Indentation Analysis | indent_analyze.c, hertz.c | Nanoindentation curve fitting (Hertz model). |
|
|
| 38 | Deconvolution | deconvolve.c | Blind/regularized deconvolution for image restoration. |
|
|
| 39 | Canny / Harris Detection | filters.c | Corner and edge feature detection beyond basic Sobel/Prewitt. |
|
|
| 40 | Kuwahara Filter | filters.c | Edge-preserving smoothing filter. |
|
|
|
|
---
|
|
|
|
## Already Implemented in tono
|
|
|
|
For reference, these Gwyddion equivalents are already covered:
|
|
|
|
| tono Node | Category | Gwyddion Equivalent |
|
|
|--------------|----------|-------------------|
|
|
| Load Image / Load SPM File | io | File import (gwy, sxm, ibw) |
|
|
| Save Image | io | File export |
|
|
| Coordinate | io | — |
|
|
| Rotate Field | modify | rotate.c |
|
|
| Flip Field | modify | basicops.c |
|
|
| Plane Level | level | level.c |
|
|
| Facet Level | level | facet-level.c |
|
|
| Polynomial Level | level | polylevel.c |
|
|
| Fix Zero | level | level.c (fix_zero) |
|
|
| Line Correction | level | linecorrect.c, linematch.c |
|
|
| Gaussian Filter | filters | filters.c (gaussian) |
|
|
| Median Filter | filters | filters.c (median) |
|
|
| Edge Detect | filters | edge.c (sobel, prewitt, laplacian, LoG) |
|
|
| 1D FFT Filter | filters | fft_filter_1d.c (lowpass, highpass, bandpass, notch) |
|
|
| 2D FFT Filter | filters | fft_filter_2d.c (lowpass, highpass, bandpass, notch) |
|
|
| Scar Removal | filters | scars.c |
|
|
| Statistics | analysis | stats.c |
|
|
| Curvature | analysis | curvature.c |
|
|
| Fractal Dimension | analysis | fractal.c |
|
|
| Height Histogram | analysis | linestats.c (dh) |
|
|
| 2D FFT | analysis | fft.c |
|
|
| Cross Section | analysis | profile tool |
|
|
| Profile Roughness | analysis | roughness.c (Ra, Rq, Rsk, Rku, Rp, Rv, Rt) |
|
|
| Line Math | analysis | linestats.c |
|
|
| Threshold Mask | mask | threshold.c, otsu_threshold.c |
|
|
| Mask Morphology | mask | mask_morph.c (erode, dilate, open, close) |
|
|
| Mask Invert | mask | — |
|
|
| Mask Operations | mask | — (boolean logic on two masks: AND, OR, XOR, NAND, NOR, XNOR, implication, etc.) |
|
|
| Grain Distance Transform | mask | mask_edt.c |
|
|
| Watershed Segmentation | grains | grain_wshed.c |
|
|
| Grain Analysis | grains | grain_stat.c |
|
|
| Preview / 3D View / Print Table | display | Presentation, 3D view |
|
|
| Tip Model | tip | tip_model.c, tip.c |
|
|
| Tip Deconvolution | tip | tip_blind.c, tip.c (gwy_tip_erosion) |
|
|
| Blind Tip Estimate | tip | tip_blind.c, morph_lib.c (gwy_tip_estimate_partial/full + gwy_tip_cmap) |
|