В этом документе представлено подробное руководство по использованию примера кода Twitter API v2 и средства визуализации Mitsuba 3. Он включает инструкции по настройке для различных языков программирования (Java, Node.js, Python, R, Ruby), подробную информацию о переменных среды и советы по устранению неполадок. Для Mitsuba 3 он предлагает руководство по установке, примеры использования и информацию о его ключевых функциях и участниках.
Пример кода Twitter API v2
Пример кода для конечных точек Twitter API v2.
Отдельные функции API имеют папки, в которых можно найти примеры использования на нескольких языках программирования (Java, Node.js, Python, R и Ruby).
Предварительные условия
Использование примеров кода
Чтобы запустить примеры из этого репозитория, вам необходимо настроить некоторые переменные среды. Вы можете найти свои учетные данные и токен носителя в приложении внутри вашего проекта на панели инструментов портала разработчика.
Для образцов OAuth 1.0a вам необходимо будет экспортировать потребительский ключ и секрет в свой терминал. Обязательно замените
Для образцов, использующих аутентификацию токена носителя, вам потребуется экспортировать токен носителя. Обязательно замените
Языковые требования
Настройка среды Java
Если вы используете Homebrew, вы можете установить среду выполнения Java, используя:
Вам также потребуется загрузить соответствующие файлы JAR, указанные в отдельных примерах, чтобы собрать и запустить код. Если вы используете IDE, возможно, она сможет сделать это автоматически.
Настройка среды JavaScript (Node.js)
Для запуска этого кода вам потребуется установить Node.js. Во всех примерах Node.js в качестве HTTP-клиента используется Needle, который необходимо установить npm. Для OAuth с запросами пользовательского контекста вам необходимо установить пакеты got и oauth-1.0a.
Настройка среды Python
Для запуска этого кода вам понадобится установленный Python 3. В примерах Python используются запросы == 2.24.0, которые используют запросы-oauthlib == 1.3.0.
(Необязательно) Обычно рекомендуется не устанавливать необходимый пакет глобально, а локально в подпапке проекта с помощью venv:
Вы можете установить эти пакеты следующим образом:
Настройка среды Ruby
Для запуска кода вам понадобится установленный Ruby (рекомендуется: >= 2.0.0). В примерах Ruby в качестве HTTP-клиента используется typhoeus, для которого необходимо установить gem. Для OAuth с запросами контекста пользователя вам также потребуется установить драгоценный камень oauth (см. ниже).
Дополнительные ресурсы
Мы поддерживаем коллекцию Postman, которую вы можете использовать для тренировки отдельных конечных точек API.
Поддерживать
По общим вопросам, связанным с API и функциями, воспользуйтесь разделом v2 на форумах сообщества разработчиков.
Если в самом образце кода обнаружена ошибка или проблема, создайте новую проблему здесь, на GitHub.
Содействие
Мы приветствуем запросы на включение, которые добавляют значимые дополнения к этим примерам кода, особенно для языков, которые еще не представлены здесь.
Мы считаем, что гостеприимное сообщество важно, и просим вас следовать Кодексу поведения Twitter с открытым исходным кодом во всех взаимодействиях с сообществом.
Лицензия
© Twitter, Inc., 2021 г.
Лицензия Apache, версия 2.0: https://www.apache.org/licenses/LICENSE-2.0.
пример:
Мицуба Рендерер 3
Документация | Обучающие видео | Линукс | MacOS | Окна | ПиПИ |
---|---|---|---|---|---|
️
Предупреждение
️
В настоящее время в мире ведется большой объем недокументированной и нестабильной работы.
master
ветка. Мы настоятельно рекомендуем вам воспользоваться нашим
последний выпуск
до дальнейшего уведомления.
Если вы уже хотите опробовать предстоящие изменения, ознакомьтесь с
это руководство по портированию.
Он должен охватывать большинство новых функций и предстоящих кардинальных изменений.
Введение
Mitsuba 3 — это исследовательская система рендеринга прямого и обратного света.
транспортное моделирование, разработанное в EPFL в Швейцарии.
Он состоит из базовой библиотеки и набора плагинов, реализующих функциональность.
начиная от материалов и источников света и заканчивая полными алгоритмами рендеринга.
Mitsuba 3 является перенацеливаемой : это означает, что базовые реализации и
Структуры данных могут трансформироваться для выполнения различных задач. Для
Например, один и тот же код может моделировать скалярный (классический по одному лучу) транспорт RGB
или дифференциальный спектральный транспорт на графическом процессоре. Все это основано на
Dr.Jit — специализированный JIT -компилятор, разработанный специально для этого проекта.
Основные характеристики
Кроссплатформенность : Mitsuba 3 была протестирована на Linux ( x86_64
), macOS.
( aarch64
, x8664
) и Windows ( x8664
).
Высокая производительность : базовый компилятор Dr.Jit объединяет код рендеринга.
в ядра, которые достигают высочайшей производительности, используя
серверная часть LLVM, ориентированная на ЦП, и серверная часть CUDA/OptiX
ориентированы на графические процессоры NVIDIA с аппаратным ускорением трассировки лучей.
Python прежде всего : Mitsuba 3 глубоко интегрирован с Python. Материалы,
текстуры и даже полные алгоритмы рендеринга могут быть разработаны на Python,
который система JIT-компилирует (и, при необходимости, дифференцирует) на лету.
Это позволяет проводить эксперименты, необходимые для исследований в области компьютерной графики и
другие дисциплины.
Дифференциация : Mitsuba 3 — это дифференцируемый рендерер, то есть он
может вычислять производные всей симуляции относительно входных данных
такие параметры, как поза камеры, геометрия, BSDF, текстуры и объемы. Это
реализует последние алгоритмы дифференцируемого рендеринга, разработанные в EPFL.
Спектральный и поляризационный : Mitsuba 3 можно использовать как монохроматический.
рендерер, рендерер на основе RGB или спектральный рендерер. Каждый вариант может
при необходимости, при необходимости, учтите эффекты поляризации.
Обучающие видеоролики, документация
Мы записали несколько видеороликов на YouTube, которые дают краткое представление.
Мицуба 3 и Доктор Джит. Помимо этого вы можете найти полные блокноты Juypter.
охватывающий различные приложения, практические руководства и справочную документацию.
на прочтенной документации.
Установка
Мы предоставляем предварительно скомпилированные двоичные колеса через PyPI. Установить Mitsuba таким способом так же просто, как запустить
pip установить Мицубу
в командной строке. Пакет Python по умолчанию включает тринадцать вариантов:
scalar_rgb
scalar_spectral
scalarspectralpolarized
llvmadrgb
llvmadmono
llvmadmono_polarized
llvmadspectral
llvmadspectral_polarized
cudaadrgb
cudaadmono
cudaadmono_polarized
cudaadspectral
cudaadspectral_polarized
Первые два выполняют классическое моделирование по одному лучу с использованием RGB
или спектральное представление цвета, тогда как последние два могут использоваться для обратного
рендеринг на CPU или GPU. Чтобы получить доступ к дополнительным вариантам, вам необходимо
скомпилируйте собственную версию Dr.Jit с помощью CMake. Пожалуйста, ознакомьтесь с
документация
для получения подробной информации об этом.
Требования
Python >= 3.8
(необязательно) Для вычислений на графическом процессоре: Nvidia driver >= 495.89
(необязательно) Для векторизованных/параллельных вычислений на ЦП: LLVM >= 11.1
Использование
Вот простой пример «Hello World», который показывает, насколько просто визуализировать
сцена с использованием Mitsuba 3 из Python:
# Импортируйте библиотеку, используя псевдоним "mi"import mitsuba as mi# Установите вариант renderermi.setvariant('scalarrgb')# Загрузите сценуscene = mi.loaddict(mi.cornellbox())# Отрисуйте сценуimg = mi. render(scene)# Запишите визуализированное изображение в файл EXRmi.Bitmap(img).write('cbox.exr')
Учебные пособия и блокноты с примерами, охватывающие различные приложения, можно найти.
в документации.
О
Этот проект создал Венцель Якоб.
Значительные функции и/или улучшения кода были внесены
Себастьян Шпейерер,
Николя Руссель,
Мерлин Нимье-Дэвид,
Делио Вичини,
Тициан Зельтнер,
Батист Николе,
Мигель Креспо,
Винсент Лерой и
Цзыи Чжан.
При использовании Mitsuba 3 в академических проектах указывайте:
@software{Mitsuba3,title = {рендерер Mitsuba 3},author = {Венцель Якоб и Себастьян Шпейерер и Николя Руссель и Мерлин Нимьер-Давид и Делио Вичини и Тициан Зельтнер и Батист Николе и Мигель Креспо и Винсент Лерой и Зийи Чжан},note = {https://mitsuba-renderer.org},версия = {3.1.1}, год = 2022}