Repository navigation
v2.1: eyelid contours with SAM 3.1
v2.1 adds eyelid/eyelid_sam31.py, which turns v2 68-point landmarks into lash-free, smooth upper and lower eyelid curves (60 points each) using SAM 3.1 text prompts. It needs no training.
- Weights: unchanged. Use
mdfld_cartoon_v2.pklfrom the v2.0 release. - Requirements: SAM 3 (facebookresearch/sam3) and the
sam3.1_multiplex.ptcheckpoint from facebook/sam3.1 (gated, SAM License), in a separate environment with a CUDA GPU. - Results on 17 in-house stills (median, 28 cartoon eyes): the share of the lash band inside the contour drops from 0.09 for the interpolated v2 landmark curve to 0.02, and roughness from 0.17 px to 0.10 px.
- Docs: setup, usage, the output format and limitations are in the README section Eyelid contours (v2.1).
Also new: CITATION.cff, so GitHub shows "Cite this repository".