Dokumen ini memberikan panduan komprehensif untuk menggunakan kode contoh Twitter API v2 dan penyaji Mitsuba 3. Ini mencakup instruksi pengaturan untuk berbagai bahasa pemrograman (Java, Node.js, Python, R, Ruby), detail tentang variabel lingkungan, dan tips pemecahan masalah. Untuk Mitsuba 3, ia menawarkan panduan instalasi, contoh penggunaan, dan informasi mengenai fitur utama dan kontributornya.
Kode contoh Twitter API v2
Contoh kode untuk titik akhir Twitter API v2.
Fitur API individual memiliki folder tempat Anda dapat menemukan contoh penggunaan dalam beberapa bahasa pengkodean (Java, Node.js, Python, R, dan Ruby).
Prasyarat
Menggunakan contoh kode
Untuk menjalankan sampel di repositori ini, Anda perlu menyiapkan beberapa variabel lingkungan. Anda dapat menemukan kredensial dan token pembawa Anda di Aplikasi di dalam Proyek Anda di dasbor portal pengembang.
Untuk sampel OAuth 1.0a, Anda perlu mengekspor kunci konsumen dan rahasia di terminal Anda. Pastikan untuk mengganti
Untuk sampel yang menggunakan autentikasi token pembawa, Anda perlu mengekspor token pembawa. Pastikan untuk mengganti
Persyaratan khusus bahasa
Pengaturan lingkungan Java
Jika Anda menggunakan Homebrew, Anda dapat menginstal runtime Java menggunakan:
Anda juga perlu mengunduh file JAR relevan yang direferensikan dalam masing-masing sampel untuk membuat dan menjalankan kode. Jika Anda menggunakan IDE, IDE mungkin dapat melakukannya secara otomatis untuk Anda.
Pengaturan lingkungan JavaScript (Node.js).
Anda harus menginstal Node.js untuk menjalankan kode ini. Semua contoh Node.js menggunakan needle sebagai klien HTTP, yang perlu diinstal npm. Untuk OAuth dengan permintaan konteks pengguna, Anda harus menginstal paket got dan oauth-1.0a.
Pengaturan lingkungan Python
Anda harus menginstal Python 3 untuk menjalankan kode ini. Sampel Python menggunakan request==2.24.0 yang menggunakan request-oauthlib==1.3.0.
(Opsional) Merupakan hal yang umum dan disarankan untuk tidak menginstal paket yang diperlukan secara global, tetapi secara lokal di bawah subfolder proyek menggunakan venv:
Anda dapat menginstal paket-paket ini sebagai berikut:
Pengaturan lingkungan Ruby
Anda harus menginstal Ruby (disarankan: >= 2.0.0) untuk menjalankan kode. Contoh Ruby menggunakan typhoeus sebagai klien HTTP, yang perlu dipasang permata. Untuk OAuth dengan permintaan konteks pengguna, Anda juga perlu menginstal permata oauth (lihat di bawah).
Sumber daya tambahan
Kami mengelola Koleksi Tukang Pos yang dapat Anda gunakan untuk menggunakan titik akhir API individual.
Mendukung
Untuk pertanyaan umum terkait API dan fitur, silakan gunakan bagian v2 di forum komunitas pengembang kami.
Jika ada bug atau masalah dengan kode contoh itu sendiri, silakan buat masalah baru di sini di GitHub.
Berkontribusi
Kami menerima permintaan penarikan yang menambahkan tambahan bermakna pada contoh kode ini, khususnya untuk bahasa yang belum terwakili di sini.
Kami merasa bahwa komunitas yang ramah adalah hal yang penting dan kami meminta Anda mengikuti Kode Etik Sumber Terbuka Twitter dalam semua interaksi dengan komunitas.
Lisensi
Hak Cipta 2021 Twitter, Inc.
Berlisensi di bawah Lisensi Apache, Versi 2.0: https://www.apache.org/licenses/LICENSE-2.0
contoh:
Penyaji Mitsuba 3
Dokumentasi | Video tutorial | Linux | macOS | jendela | PyPI |
---|---|---|---|---|---|
️
Peringatan
️
Saat ini terdapat sejumlah besar pekerjaan tidak terdokumentasi dan tidak stabil yang terjadi
cabang master
. Kami sangat menyarankan Anda menggunakan kami
rilis terbaru
sampai pemberitahuan lebih lanjut.
Jika Anda sudah ingin mencoba perubahan yang akan datang, silakan lihat
panduan porting ini.
Ini harus mencakup sebagian besar fitur baru dan perubahan penting yang akan datang.
Perkenalan
Mitsuba 3 adalah sistem rendering berorientasi penelitian untuk cahaya maju dan mundur
simulasi transportasi dikembangkan di EPFL di Swiss.
Ini terdiri dari perpustakaan inti dan satu set plugin yang mengimplementasikan fungsionalitas
mulai dari bahan dan sumber cahaya hingga algoritma rendering lengkap.
Mitsuba 3 dapat ditargetkan ulang : ini berarti implementasi yang mendasarinya dan
struktur data dapat bertransformasi untuk menyelesaikan berbagai tugas berbeda. Untuk
Misalnya, kode yang sama dapat mensimulasikan transpor RGB skalar (klasik satu sinar pada satu waktu).
atau transportasi spektral diferensial pada GPU. Ini semua didasarkan pada
Dr.Jit, kompiler just-in-time (JIT) khusus yang dikembangkan khusus untuk proyek ini.
Fitur Utama
Lintas platform : Mitsuba 3 telah diuji di Linux ( x86_64
), macOS
( aarch64
, x8664
), dan Windows ( x8664
).
Performa tinggi : Kompiler Dr.Jit yang mendasari menggabungkan kode rendering
menjadi kernel yang mencapai kinerja canggih dengan menggunakan
backend LLVM yang menargetkan CPU dan backend CUDA/OptiX
menargetkan GPU NVIDIA dengan akselerasi perangkat keras ray tracing.
Python pertama : Mitsuba 3 sangat terintegrasi dengan Python. Bahan,
tekstur, dan bahkan algoritma rendering penuh dapat dikembangkan dengan Python,
yang dikompilasi oleh sistem JIT (dan secara opsional dibedakan) dengan cepat.
Hal ini memungkinkan eksperimen yang diperlukan untuk penelitian dalam grafik komputer dan
disiplin ilmu lainnya.
Diferensiasi : Mitsuba 3 adalah penyaji yang dapat dibedakan, artinya itu
dapat menghitung turunan dari keseluruhan simulasi sehubungan dengan masukan
parameter seperti pose kamera, geometri, BSDF, tekstur, dan volume. Dia
mengimplementasikan algoritma rendering terdiferensiasi terbaru yang dikembangkan di EPFL.
Spektral & Polarisasi : Mitsuba 3 dapat digunakan sebagai monokromatik
penyaji, penyaji berbasis RGB, atau penyaji spektral. Setiap varian bisa
secara opsional memperhitungkan efek polarisasi jika diinginkan.
Video tutorial, dokumentasi
Kami telah merekam beberapa video YouTube yang memberikan pengenalan lembut
Mitsuba 3 dan Dr.Jit. Selain itu, Anda dapat menemukan buku catatan Juypter lengkap
mencakup berbagai aplikasi, panduan cara kerja, dan dokumentasi referensi
di readthedocs.
Instalasi
Kami menyediakan roda biner yang telah dikompilasi sebelumnya melalui PyPI. Menginstal Mitsuba dengan cara ini semudah menjalankannya
pip instal mitsuba
pada baris perintah. Paket Python mencakup tiga belas varian secara default:
scalar_rgb
scalar_spectral
scalarspectralpolarized
llvmadrgb
llvmadmono
llvmadmono_polarized
llvmadspectral
llvmadspectral_polarized
cudaadrgb
cudaadmono
cudaadmono_polarized
cudaadspectral
cudaadspectral_polarized
Dua yang pertama melakukan simulasi klasik satu sinar pada satu waktu menggunakan RGB
atau representasi warna spektral, sedangkan dua yang terakhir dapat digunakan untuk invers
rendering pada CPU atau GPU. Untuk mengakses varian tambahan, Anda perlu melakukannya
kompilasi versi khusus Dr.Jit menggunakan CMake. Silakan lihat
dokumentasi
untuk rincian tentang ini.
Persyaratan
Python >= 3.8
(opsional) Untuk komputasi pada GPU: Nvidia driver >= 495.89
(opsional) Untuk komputasi vektor/paralel pada CPU: LLVM >= 11.1
Penggunaan
Berikut adalah contoh sederhana "Hello World" yang menunjukkan betapa sederhananya merender a
adegan menggunakan Mitsuba 3 dari Python:
# Impor perpustakaan menggunakan alias "mi"impor mitsuba sebagai mi# Atur varian renderermi.setvariant('scalarrgb')# Muat scene = mi.loaddict(mi.cornellbox())# Render sceneimg = mi. render(adegan)# Tulis gambar yang dirender ke file EXRmi.Bitmap(img).write('cbox.exr')
Tutorial dan contoh buku catatan yang mencakup berbagai aplikasi dapat ditemukan
dalam dokumentasi.
Tentang
Proyek ini dibuat oleh Wenzel Jakob.
Fitur-fitur penting dan/atau perbaikan pada kode disumbangkan oleh
Sébastien Speierer,
Nicolas Roussel,
Merlin Nimier-David,
Delio Vicini,
Tizian Zeltner,
Baptiste Nicolet,
Miguel Crespo,
Vincent Leroy, dan
Ziyi Zhang.
Saat menggunakan Mitsuba 3 dalam proyek akademik, harap kutip:
@software{Mitsuba3,title = {Mitsuba 3 renderer},author = {Wenzel Jakob dan Sébastien Speierer dan Nicolas Roussel dan Merlin Nimier-David dan Delio Vicini dan Tizian Zeltner dan Baptiste Nicolet dan Miguel Crespo dan Vincent Leroy dan Ziyi Zhang},catatan = {https://mitsuba-renderer.org},versi = {3.1.1},tahun = 2022}