Visualize FastAPI endpoints with FastAPI-Voyager
FastAPI Voyager - это интерактивный инструмент визуализации для API, созданный на базе FastAPI. Позволяет наглядно представлять структуру API с возможностью масштабирования через прокрутку и детального изучения узлов двойным кликом. Особенность инструмента - режим просмотра зависимостей схемы (активируется через Shift+клик), который фильтрует несвязанные узлы, упрощая анализ сложных систем.
Проект поддерживает импорт данных JSON из ядра системы, что обеспечивает гибкость интеграции. Инструмент ориентирован на разработчиков, работающих с FastAPI, и помогает лучше понимать архитектуру API, выявлять связи между компонентами и оптимизировать структуру. Код проекта доступен на GitHub, что позволяет сообществу вносить вклад в развитие и адаптацию инструмента под конкретные нужды.
Комментарии (18)
- Пользователи жалуются на неудобство визуализации сложных связей между эндпоинтами и моделями ответов в fastapi-voyager; требуется более интерактивный и «чистый» способ исследовать схему.
- Предложение: добавить взаимодействие при наведении курсора на узел, чтобы подсвечивать связанные с ним линии и скрывать остальные, а также дать возможность «проваливаться» внутрь подграфа.
- Пользователи просят улучшить UX: убрать «клубок» линий, дать возможность масштабировать и фильтровать отображаемое, а также предоставить обзорный режим, в котором детали раскрываются по мере необходимости.
- Проект вдохновлен GraphQL-voyager, но не реализует его фичи вроде подсветки связей при наведении мыши; автор отвечает, что проект на ранней стадии и приветствует PR-ы.
Комментарии (79)
- Обсуждение выявило множество проблем с качеством исходных данных: клубы путаются с барами, отсутствуют важные площадки, а визуализации не показывают, как эти данные могут быть полезны.
- Критика также затрагивает визуализацию: она красива, но не показывает, как она может быть использована, и не отвечает на вопросы о демографии посетителей.
- В дискуссии поднимаются вопросы о том, какие именно места стоит включать в датасет, и какие критерии использовать для определения "популярности".
- Некоторые комментаторы указывают на то, что визуализация не показывает, какие именно диджеи играют в клубах, и что это может быть важнее, чем просто список клубов.
- В целом, обсуждение подчеркивает, что визуализация красива, но не решает проблему отсутствия или неточности в данных, и не показывает, как она может быть использована для принятия решений.
Show HN: See chords as flags – Visual harmony of top composers on musescore
К сожалению, у меня нет полного содержимого статьи "Rawl: Visual Music Theory" для создания точного пересказа. Вы предоставили только заголовок и сообщение о необходимости включить JavaScript для запуска приложения.
Для создания качественного саммари в формате Markdown (~170 слов) мне нужен полный текст статьи или, как минимум, основные тезисы, ключевые идеи и важные детали, которые стоит включить в пересказ.
Пожалуйста, предоставьте больше информации о содержании статьи, и я с удовольствием создам для вас точный и лаконичный пересказ.
Комментарии (27)
- Визуализация в виде "пианино-ролла" упрощает анализ аккордов и каденций, но жертвует почти всей остальной информацией нотного стана.
- Цветовое кодирование основано на тональности, а не на абсолютной высоте; транспозиция меняет цвета, но не влияет на функциональную роль нот.
- Пользователи обсуждают, какие компромиссы между полнотой и читабельностью наиболее приемлемы, и какие еще инструменты могли бы помочь в анализе музыки.
The shadows lurking in the equations 🔥 Горячее
Традиционная визуализация математических уравнений использует бинарный режим, показывая только точные решения, где уравнение точно равно нулю. FuzzyGraph предлагает не-бинарный подход, визуализируя не только точные решения, но и области, где уравнение почти равно или сильно отклоняется от равенства. Эти "математические тени" или "черные дыры" остаются невидимыми в традиционных графиках, но могут содержать важную информацию о поведении уравнений.
Примеры демонстрируют впечатляющие различия: для уравнения "Slash Dot" FuzzyGraph выявляет гигантскую "черную дыру", полностью невидимую в бинарном представлении. Уравнение "Quasar" показывает глазоподобные структуры, также скрытые от традиционного графирования. Даже простые уравнения, такие как "Черная дыра" (1/(x²+y²)=0), не имеют решений в бинарном режиме, но FuzzyGraph визуализирует их математическую топографию. Эти "тени" не всегда похожи на черные дыры - иногда они образуют линии или другие сложные структуры, раскрывая скрытые аспекты математических объектов.
Комментарии (85)
- Обсуждение развернулось вокруг того, что авторы называют «fuzzy graph» просто визуализируют погрешность, а не решают уравнение.
- Участники обсуждали, что «цветная» версия графика по сути показывает, насколько точка отклоняется от равновесия, а не само решение.
- Некоторые комментаторы отметили, что подобные визуализации полезны для иллюстрации градиента ошибки и чувствительности модели к шуму в данных.
- Были упомянуты инструменты вроде Desmos 3D и CalcPlot3D, которые позволяют пользователям самостоятельно экспериментировать с подобными визуализациями.
- Несколько участников подчеркнули, что визуализация «размытого» графика не нова и используется в машинном обучении для отображения ошибки модели.
VimGraph
—
Комментарии (27)
- Обсуждение вызвало вопросы о практической ценности графика, но большинство комментариев скорее ставят под сомнение его полезность, чем предлагают конструктивные примеры использования.
- Участники обсуждения также затрагивают тему эффективности использования различных движений и команд в vim, включая плагины и альтернативные подходы.
- Некоторые комментарии поднимают вопрос о том, что график может быть полезен для обучения или визуализации, но неясно, как он может быть использован в практической работе.
- В целом, обсуждение показывает, что сообщество вокруг vim и подобных инструментов разработано настолько, что участники могут обсуждать и критиковать даже самые базовые идеи и примеры, но при этом не предлагая конструктивные альтернативы.
Show HN: Strange Attractors 🔥 Горячее
Статья исследует странные аттракторы — математические концепции, создающие красивые паттерны из простых уравнений. Автор, экспериментируя с Three.js, обнаружил, что сложные визуальные образы возникают из трёх базовых уравнений, что поглотило его время и внимание. Странные аттракторы демонстрируют, как порядок может рождаться из хаоса, что оказалось для автора глубоко удовлетворительным наблюдением.
Динамические системы описывают, как вещи меняются во времени, следуя определённым правилам. Фазовое пространство представляет все возможные состояния системы, а динамика определяет переходы между этими состояниями. Теория хаоса изучает системы, которые кажутся случайными, но на самом деле следуют детерминированным правилам. Такие системы, как погода или экономика, чрезвычайно чувствительны к начальным условиям — малейшее изменение может привести к совершенно разным результатам, что известно как эффект бабочки.
Комментарии (71)
- Обсуждение показало, что визуализация 3D-фазового пространства привела к всплеску ностальгии по 90-м и эпохе Fractint, а также подчеркнула, что современные технологии позволяют в реальном времени рендерить то, что раньше требовало часов рендеринга.
- Участники делились личными историями, от вдохновляющих всплесков любознательности до вдохновляющих влияний на их карьеру.
- Обсуждались идеи добавить параметры для взаимодействия, такие как изменение цвета точек в зависимости от их положения в пространстве фаз, что может быть реализовано в будущем.
- Также обсуждались вопросы открытого исходного кода и использования визуализации в образовательных целях.
- Были сделаны ссылки на старые и новые инструменты, такие как Fractint и современные библиотеки визуализации.
Комментарии (81)
- RGB — это модель, а не цветовое пространство; sRGB и Rec.2020 — это примеры последнего.
- Пользователи просят остановить вращение, показать имя цвета при наведении и выводить его в привычных им единицах (HEX, RGB%, HSL).
- Обсуждается влияние культуры и языка на набор названий, а также то, что в английском «cyan» и «aqua» могут обозначать один и тот же цвет.
- Поднимается вопрос о том, какие области цветового пространства не покрыты именованными цветами, и предлагается показать «пустоты» на карте.
- Пользователи спрашивают, можно ли экспортировать данные и какой формат будет наиболее устойчив к будущему.
Show HN: Diagram as code tool with draggable customizations
oxdraw — это инструмент для создания диаграмм с помощью кода, написанный на Rust с поддержкой перетаскивания элементов. Проект позволяет разработчикам создавать визуальные диаграммы, используя текстовое описание, что упрощает версионирование и интеграцию с существующими рабочими процессами. Написанный на производительном языке Rust, oxdraw обеспечивает быструю работу даже с сложными диаграммами.
Ключевая особенность инструмента — возможность интерактивного редактирования диаграмм с помощью мыши. Пользователи могут создавать элементы кодом, а затем перетаскивать их для изменения расположения без необходимости редактировать исходный код. Такой подход сочетает преимущества декларативного описания диаграмм с интуитивным визуальным редактированием, что делает инструмент полезным как для разработчиков, предпочитающих работу с кодом, так и для тех, кто предпочитает визуальный дизайн.
Комментарии (44)
- Пользователи обсуждают различные инструменты для диаграмм: Mermaid.js, D2, PlantUML и Graphviz, а также их ограничения и возможности.
- Обсуждается необходимость улучшения автоматического размещения для Mermaid.js и возможность встроить инструмент в качестве layout engine.
- Участники поднимают вопросы о лицензии (отсутствие файла LICENSE), отсутствии функционала вроде всплывающих подсказок и коллапсинга нод, а также о том, что проект не предоставляет встроенного способа взаимодействия с инструментами вроде Excalidraw.
- Разработчик отвечает, что проект находится в стадии разработки и что он открыт к вкладу со стороны сообщества.
Picturing Mathematics
James Propp подчеркивает важность визуализации в математике, несмотря на свою преданность "low-tech" подходам. В 2016 году в ICERM прошел воркшоп "Illustrating Mathematics", объединивший исследователей, изучающих абстракции, оживляемые визуально. Это spawned сообщество, проводящее встречи и вебинары с 2023 года. Propp дважды выступал на вебинарах: в 2024 почтил память Roger Antonsen, мастера визуализаций, а в октябре 2025 представил "Evolving cross sections of Ford spheres", получив позитивный отклик от сообщества.
Ford spheres - трехмерный фрактал, описанный Lester Ford в 1938 году, за 37 лет до Mandelbrot. Они связаны с Ford circles - двумерным фракталом, являющимся геометрическим представлением рациональных чисел. Propp считает, что Ford spheres заслуживают изучения и визуализации, так как могут преподать новые математические секреты. Их контринтуитивное поведение делает их особенно интересными для математиков и нематематиков.
Комментарии (3)
- @emil-lp отмечает презентацию о красоте математики в формате 4:3 beamer.
- @rramadass рекомендует TED-доклад Roger Antonsen о визуализации паттернов в математике через смену перспектив.
- @gsf_emergency_4 ссылается на статью о Coupling from the Past и восхищается разъясняющим стилем автора.
- @gsf_emergency_4 сожалеет, что автор перестал комментировать, считая личные посты лучшим контентом для HN.
Show HN: ASCII Automata
ASCII AUTOMATA v2 (beta) — это интерактивный инструмент для создания ASCII-искусства с помощью клеточных автоматов. Пользователи могут настраивать размер ячеек, выбирать шрифты и управлять различными параметрами сетки. Интерфейс включает режимы рисования (GROW, MANUAL, BARRIER) и инструменты вроде DRAW RECT для создания прямоугольников. Система предлагает пять стилей роста (DEPTH, PARALLEL, RANDOM, SCATTER, SCAN) с возможностью настройки селективности, случайного шанса и близости элементов.
Программа предоставляет три метода подсчета очков (DISTANCE, CONNECTION, EXACT) с поддержкой взвешенных значений для диагональных и кардинальных направлений. Управление анимацией осуществляется через кнопки PLAY, STOP и NEXT. Созданные работы можно экспортировать в PNG или скопировать как текст. Инструмент разработан Хейкки Лотвоненом (Heikki Lotvonen) в 2025 году и включает функцию RANDOM SEED для генерации уникальных паттернов.
Комментарии (8)
- ASCII AUTOMATA анализирует визуальную связность символов в текстовых шрифтах, оценивая краевую связность фрагментов и подбирая соседние для "роста".
- Инструмент визуализирует частоту использования символов через красную тепловую карту.
- Участники высоко оценили инструмент, сравнив его с 10print.org и отметив креативность подхода.
- Предложено добавить поддержку PETSCII шрифта.
Комментарии (39)
- Критика стиля и содержания поста Вольфрама: много визуализаций без ясной цели, изобретение непонятного термина "ruliology", самопрезентация автора.
- Положительные отзывы: пост как хорошее введение в лямбда-исчисление, демонстрация ценности визуализации даже абстрактных концепций, стимулирующий и ясный стиль написания.
- Сравнение с другими систематическими работами: упоминание функционального аналога "занятого бобра" (A333479) и вопроса о простоте анализа по сравнению с машинами Тьюринга.
- Обсуждение целевой аудитории: пост написан не для инженеров-программистов, а для физиков и математиков, изучающих вычисления.
- Упоминание концепций Вольфрама: "ruliad" (вселенная как программа) и "ruliology" как их изучение, переоткрытие тезиса Чёрча-Тьюринга.
The Little Book of Linear Algebra 🔥 Горячее
Репозиторий the-litte-book-of/linear-algebra на GitHub.
Эпиграф Жана Дьёдонне: «Линейная алгебра — почти самая элементарная теория, хотя преподаватели и авторы учебников на протяжении поколений затемняли её простоту чудовищными выкладками с матрицами».
Меню навигации, вход, настройки внешнего вида, поиск и другие стандартные элементы GitHub опущены.
Комментарии (104)
- Линейная алгебра считается глубокой и полезной, но базовая механика скучна.
- Многие советуют начинать с геометрической интуиции и визуализации (3Blue1Brown, «Wild Linear Algebra», mini-book photon_lines).
- Книга Axler «Linear Algebra Done Right» и курс Hefferon хвалятся за строгий, но понятный подход.
- Практика в графике/3D, экономике, машинном обучении и сжатии JPEG делает тему мотивирующей.
- Сообщество жалуется на плохое преподавание и просит больше визуальных объяснений, меньше «так надо».
Git Diagramming "The Weave"
Git-граф «плетения» Трампа
Трамп называет свою манеру речи «the weave»: он перескакивает между темами, а потом «все блестяще сводится воедино». Я решил визуализировать это как git-граф.
Использовал Mermaid.js, но горизонтальная схема не подошла, поэтому написал компонент <git-graph>.
Фрагмент из транскрипта совещания в Овальном кабинете:
%%{init: { 'theme': 'base' } }%%
gitGraph
commit id:"CBO: тарифы принесут $4 трлн"
branch radical-left
commit id:"радикальные левые признали Трампа правым"
checkout main
merge radical-left
commit id:"$4 трлн сократят дефицит"
branch stock-market
commit id:"рынок +1000 пунктов"
branch world-respect
commit id:"весь мир нас уважает"
branch fifa-event
commit id:"финал FIFA в Kennedy Center"
branch kennedy-center-remodel
commit id:"ремонт займёт год"
branch oval-office-remodel
commit id:"золото в Овальном кабинете"
branch painting-vault
commit id:"картины великих президентов из хранилища"
Каждая ветка — новая тема, cherry-pick — возврат к уже сказанному.
Комментарии (59)
- Участники обсуждают «ткацкий» стиль речи, когда тема раскрывается «ветвями», сливающимися лишь в финале.
- Предложены улучшения диаграмм: показывать название ветви рядом с «New Topic» и использовать Sankey- или top-to-bottom-режимы.
- Некоторые считают визуализацию забавной и полезной для анализа «словесного салата» политиков и бизнесменов.
- Подняты технические проблемы: сломанный рендеринг в iOS и Firefox, отсутствие тестов и дисклеймеров.
- Обсуждение быстро скатилось в политические споры: «хит-пьеса» против Трампа, сравнение с Обамой, обвинения в трусости и «сенильности».
Show HN: ChartDB Cloud – Visualize and Share Database Diagrams
ChartDB — инструмент для интерактивной визуализации схем БД.
Поддерживает PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, CockroachDB, MongoDB.
Ключевые возможности
- Импорт схемы одним кликом из любой поддерживаемой СУБД.
- Авто-раскладка таблиц и связей; ручное перемещение.
- Экспорт в форматы PNG, SVG, PDF.
- Режим «одной страницы» для быстрого просмотра.
- Поиск и фильтрация по названию таблицы или столбца.
- Тёмная и светлая темы.
Быстрый старт
- Открыть chartdb.io.
- Нажать «Import from DB», вставить строку подключения или SQL-дамп.
- Получить готовую схему за секунды.
Комментарии (12)
- Некоторые команды продолжают рисовать ERD и документировать именно схему БД, особенно при проектировании новых фич и онбординге.
- Другие полагаются на абстракции вроде ORM/DDD и считают диаграммы избыточными, особенно для типовых SaaS с generic auth и payment.
- Инструменты вроде dbdiagram.io, Lucidchart и ChartDB спросом пользуются, но часто ломаются при >15 таблиц или требуют изучения нового UI.
- Сторонники диаграмм аргументируют: «базы живут дольше абстракций», а отсутствие документации — потеря для индустрии.
Prime Number Grid 🔥 Горячее
Prime Grid
Старт
Строки
Столбцы
« » ·
Для работы страницы требуется включённый JavaScript.
Комментарии (90)
- Пользователи делятся ссылками на визуализаторы простых чисел и обсуждают разные способы отображения: решётки, Ulam spiral, «упаковки» по 100 чисел.
- Отмечают, что при простом числе колонок возникают диагональные полосы из-за одинаковых остатков по модулю.
- Удивляются «густоте» простых даже на больших числах, хотя теорема о простых числах говорит о снижении плотности как 1/log n.
- Просят добавить hover-числа, анимацию, другие основания, 3-D, экспорт изображений.
- Кто-то видит в узорах логотипы, «звёздные врата» или даже «клингонский» текст; другие предупреждают, что часть узоров — псевдопаттерны.
A Visual Exploration of Gaussian Processes (2019)
Гауссовские процессы визуально
Гауссовские процессы (ГП) — это вероятностный метод регрессии, который не просто подгоняет кривую, а выдаёт распределение по всем возможным функциям, совместимым с данными. Среднее этого распределения — наилучшее предсказание; дисперсия — мера неопределённости. ГП применимы к регрессии, классификации и кластеризации.
Многомерное нормальное распределение
ГП строятся на многомерной нормальности
$X \sim \mathcal N(\mu,\Sigma)$.
- $\mu$ — вектор средних.
- $\Sigma$ — симметричная, положительно полуопределённая ковариационная матрица: диагональ $\sigma_i^2$ задаёт дисперсии, вне-диагональ $\sigma_{ij}$ — корреляции.
Интерактивный пример показывает, как меняется форма плотности при изменении $\mu$ и $\Sigma$.
Маргинализация и условие
У нормального распределения важное свойство:
- Маргинализация — переход к подмножеству переменных сохраняет нормальность.
- Условие — распределение переменной при фиксированных других тоже нормально.
Эти операции лежат в основе вывода ГП: наблюдая часть точек, мы получаем нормальное апостериорное распределение на остальных.
От многомерной нормали к ГП
ГП обобщает многомерную нормальность на континуум индексов (например, все точки времени или пространства). Любой конечный набор значений функции имеет совместное нормальное распределение. Задаётся:
- Средняя функция $m(x)$ (часто $m(x)=0$).
- Ковариационная функция $k(x,x')$, задающая гладкость и масштаб.
Популярные ядра:
- RBF (радиальная): $\exp(-\tfrac{|x-x'|^2}{2\ell^2})$ — гладкие функции.
- Периодическое: $\exp(-\tfrac{2\sin^2(\pi|x-x'|/p)}{\ell^2})$ — повторяющиеся паттерны.
- Рациональное квадратичное: $(1+\tfrac{|x-x'|^2}{2\alpha\ell^2})^{-\alpha}$ — промежуточная гладкость.
Интерактив позволяет менять гиперпараметры $\ell$ (характерная длина) и $\sigma$ (амплитуда) и видеть, как меняются выборки функций.
Регрессия с ГП
- Выбираем ядро и гиперпараметры.
- Вычисляем ковариационную матрицу на обучающих точках $K_{XX}$.
- Добавляем шум $\sigma_n^2 I$ для учёта наблюдательной ошибки.
- Условное распределение на новых точках даёт предсказание и доверительные интервалы.
Формула предсказания:
$\bar f_* = K_{X}(K_{XX}+\sigma_n^2 I)^{-1} y$
$\text{cov}(f_) = K_{**} - K_{X}(K_{XX}+\sigma_n^2 I)^{-1} K_{X}$.
Интерактив показывает, как добавление точек уменьшает неопределённость.
Обучение гиперпараметров
Маржинальное правдоподобие
$\log p(y|X) = -\tfrac12 y^T(K+\sigma_n^2 I)^{-1}y - \tfrac12\log|K+\sigma_n^2 I| - \tfrac n2 \log 2\pi$
максимизируется по $\ell,\sigma,\sigma_n$ через градиентный спуск. Интерактив демонстрирует поверхность лог-правдоподобия и оптимум.
Дополнения
- Нетривиальные ядра: суммы и произведения базовых (например, тренд + сезонность).
- Стохастические процессы: ГП можно рассматривать как случайные функции, что полезно для байесовской оптимизации.
- Сложности: $O(n^3)$ по числу точек; для больших данных применяют разреженные или приближённые методы.
Итог
Гауссовские процессы превращают маленькие математические блоки в мощный инструмент вероятностного моделирования. Надеемся, что интерактивные примеры помогли увидеть, как работает этот метод и как его настроить под свои данные.
Комментарии (1)
- Пользователь восторгается интерактивной визуализацией и спрашивает, какой инструмент использовался.
- Уточнение: авторы применяют шаблон Distillpub и пишут D3.js «вручную».
- Это даёт высочайшее качество, но требует огромных усилий и времени.
- Поэтому проект давно офлайн — поддерживать такой уровень сложно.
- Пользователь надеется, что появится технология, которая упростит создание подобных визуализаций.
Simulating and Visualising the Central Limit Theorem
Кратко о ЦПТ
Если из любого распределения с конечным средним и дисперсией брать выборки размера n и считать их средние, то при n → ∞ распределение этих средних стремится к нормальному.
Эксперимент
Сгенерировано по 10 000 значений из шести распределений: uniform, normal, binomial, beta, exponential, χ².
Функция take_random_sample_mean() берёт случайную выборку размера 60 и возвращает среднее. Повторено 20 000 раз.
take_random_sample_mean <- function(data, n) {
slice_sample(data, n = n) |> summarise(across(everything(), list(mean = mean, sd = sd)))
}
Результаты
Гистограммы 20 000 средних показывают, что даже для сильно ненормальных исходных распределений форма распределения средних близка к нормальной.
Комментарии (55)
- Обсудили аналог ЦПТ для экстремумов — теорему Фишера–Типпета–Гнеденко (GEV).
- Подчеркнули важность симуляций для интуитивного понимания ЦПТ и поделились ссылками на визуализации.
- Отметили, что скорость сходимости к нормальному распределению зависит от исходного распределения (экспоненциальное сходится медленнее).
- Упомянули обобщения ЦПТ: для распределений без конечной дисперсии, ряды Эджворта, устойчивые распределения.
- Предупредили о риске завышенных ожиданий из-за «хорошо ведущих себя» примеров и дали ссылки на литературу.
Show HN: Prime Number Grid Visualizer
Prime Grid — интерактивная сетка, выводящая простые числа слева-направо и сверху-вниз. Меняй строки и столбцы, ищи визуальные узоры, занимайся «умной» математикой или разгадывай код вселенной.
Уже существует? Не знаем.
Зачем нужно? Тоже не знаем.
Лайфхак: кликни в поле «столбцы», зажми стрелку «вверх» и наблюдай каскадные эффекты.
Дэнни Дуплекс
Комментарии (44)
- Пользователи наблюдают «галактические» вращения и спирали при прокрутке количества колонок, особенно вокруг 400–431.
- Найдены «пустые» диапазоны при 546 колонках: интервалы 243–249 и 297–303 не содержат простых чисел, что объясняется делимостью на множители 546.
- Предложены новые функции: инверсия сетки (показ составных), старт с любого числа, подсветка при клике, фильтрация по простым с заданным арифметическим условием, пропуск чётных и чисел, оканчивающихся на 5.
- Несколько человек сравнили визуализации с Ulam-спиралью, 3Blue1Brown и даже задумались о «порталах» и Game of Life.