Open-source

Faithful Contouring — воксельное представление 3D-мешей

Обзор по документации проекта · Проверено

Faithful Contouring — изображение проекта

Faithful Contouring (FaithC) — метод представления 3D-моделей в виде вокселей. Он предназначен для разработчиков и исследователей в области 3D-графики, компьютерного зрения и машинного обучения, которым требуется воксельное представление мешей. Метод позволяет избежать проблем, связанных с традиционным подходом SDF (Signed Distance Field) и Marching Cubes, таких как утолщение поверхности, зазубренные изоповерхности и потеря внутренних структур.

Возможности и состав проекта

FaithC работает напрямую с исходной сеткой, определяя воксели, пересекающие поверхность. Для каждого такого вокселя система вычисляет набор локальных характеристик, называемых Faithful Contour Tokens (FCTs). Эти токены включают координаты опорной точки, нормаль к поверхности и знаки пересечения рёбер. Токены позволяют восстанавливать геометрию, сохраняя острые грани и внутренние структуры даже для незамкнутых или неманифолдных сеток. Каждый активный воксель кодируется 18-мерным токеном.

Начало работы и требования

Для работы FaithC требуется графический процессор NVIDIA с поддержкой CUDA, Python 3.10+ и PyTorch 2.5+. Проект распространяется под лицензией Apache License 2.0. Есть экспериментальная поддержка AMD GPU с ROCm. Разработчики могут установить проект вручную или использовать менеджер пакетов Pixi для автоматической настройки всех зависимостей. Проект включает API для кодирования и декодирования, а также демонстрационные скрипты.

Ограничения и выбор сценария

Сохранение геометрии и сравнения с SDF относятся к методу и экспериментам авторов; для своих мешей нужно проверять ошибки восстановления. Основной путь требует NVIDIA/CUDA, а AMD/ROCm обозначен экспериментальным. Установка через Pixi также загружает зависимости и требует дискового пространства.

Лицензия и условия использования

GitHub определяет лицензию репозитория как Apache-2.0. Перед использованием и распространением проверьте полный текст LICENSE и отдельные условия зависимостей, данных или моделей: лицензия репозитория не заменяет их лицензии.

Источники и документация