Kami sangat senang mengumumkan rilis Bokeh 3.1! Rilis ini mencakup beberapa pembaruan penting termasuk acara dokumen yang disempurnakan, overlay pilihan yang persisten, pemilih tanggal, waktu dan waktu yang baru, dan visual yang lebih kaya untuk Textmesin terbang.

Posting ini menguraikan pembaruan yang menurut kami akan sangat berguna bagi sebagian besar pengguna (lihat log perubahan dan catatan rilis untuk semua detail).

Dokumentasikan acara

Fitur yang telah lama diminta adalah kemampuan untuk menentukan panggilan balik JavaScript untuk peristiwa dokumen seperti "siap" atau "koneksi terputus" . Sebelumnya, hanya event “ready” yang ada, dan hanya mendukung callback Python. Sekarang, semua peristiwa dokumen—termasuk peristiwa "koneksi terputus" yang baru —mendukung panggilan balik Python dan Javascript:

• DocumentReady— dipancarkan saat BokehJS telah menyelesaikan inisialisasi untuk dokumen tertentu
• ConnectionLost— dipancarkan saat koneksi websocket ke server Bokeh terputus

curdoc().js_on_event("connection_lost", CustomJS(code="""
    alert("Connection lost!")
""")

      
                

                    
                    
                
            

Gaya CSS sekarang dapat diterapkan secara terprogram, dengan Stylesobjek baru:

style = Styles(
    display="grid",
    grid_template_columns="auto auto",
    column_gap="10px",
)
grid = Div(style=style)

from bokeh.models import InlineStyleSheet

stylesheet = InlineStyleSheet(
    css=".bk-slider-title { background-color: lightgray; }"
)

slider = Slider(
    value=10, start=0, end=100, step=0.5, stylesheets=[stylesheet]
)

Hamparan Seleksi Persisten

Bokeh sekarang mendukung hamparan pemilihan kotak, poli, dan laso yang persisten. Ini dapat diaktifkan dengan mengatur persistentproperti pada masing-masing alat pilih. Fitur ini memungkinkan pengguna untuk berinteraksi dengan hamparan yang dipilih setelah pemilihan awal selesai, dengan memindahkannya atau mengubah bentuk dan ukurannya. Pengguna dapat menyempurnakan pilihan sesuai kebutuhan, tanpa harus memulai dari awal. Hamparan pilihan tetap ada di antara perubahan alat, sehingga pengguna dapat membuat pilihan, menggeser atau memperbesar, lalu terus menyempurnakan pilihan yang sama.

Perbaikan Visual pada mesin terbang Teks

Mesin terbang yang ada Textterbatas pada teks biasa, sehingga pengguna harus beralih ke anotasi seperti LabelSetatau membuat beberapa mesin terbang untuk mendapatkan visual teks yang lebih kaya. Sekarang, pengguna dapat mengonfigurasi visual latar belakang dan batas, radius batas, padding, dan jangkar untuk Textmesin terbang.

Di masa mendatang, Textglyph akan menjadi alat utama yang digunakan untuk label dan anotasi teks.

Sudut membulat

Semua mesin terbang persegi panjang ( Rect, Block, Quad, HBardan VBar) serta BoxAnnotationmendapatkan dukungan untuk properti baru border_radius. Properti ini memberikan sudut membulat untuk semua mesin terbang, dan berfungsi untuk ketiga backend:

Legenda

Sebelumnya, legenda mendukung tata letak baris atau kolom tunggal, bergantung pada orientasinya. Di Bokeh 3.1, dimungkinkan untuk membuat legenda grid dengan menggunakan properti nrowsand ncols.

Judul legenda dapat diposisikan di kedua sisi legenda, dan mendukung teks multibaris. Terakhir, ada juga properti baru untuk mengonfigurasi latar belakang item legenda.

Widget tanggal, waktu dan waktu

Bokeh sudah memiliki DatePicker, yang memungkinkan untuk memilih satu nilai tanggal. Rilis ini menambahkan dukungan untuk memilih beberapa tanggal dan rentang tanggal. Dukungan juga ditambahkan untuk waktu dan tanggal:

• DatetimePicker
• DatetimeRangePicker
• MultipleDatetimePicker
• DateRangePicker
• MultipleDatePicker
• TimePicker

Semua widget baru mendukung pemformatan tanggal dan waktu khusus.

Isi area dalam anotasi Lereng

Anotasi Slopesekarang mendukung konfigurasi area isian di atas dan di bawah garis miring yang ditentukan oleh anotasi:

Tumpukan gambar yang dipetakan dengan warna

Rilis ini juga menyertakan dukungan untuk tumpukan gambar yang dipetakan dengan warna. Setiap gambar dalam tumpukan memiliki warnanya sendiri dan tumpukan tersebut dirender menggunakan rata-rata tertimbang dari masing-masing warna tersebut:

Rilis mendatang akan dibangun di atas pekerjaan ini untuk menambahkan interaksi baru, misalnya tingkat pemetaan warna tumpukan gambar satu per satu, sehingga seluruh tumpukan dapat digosok secara interaktif.

Bilah warna

Metode kenyamanan construct_color_baryang baru-baru ini ditambahkan ke perender kontur sangat bagus, kami memutuskan untuk menambahkannya ke semua perender mesin terbang. Metode ini akan mencari mapper warna yang ditentukan untuk properti warna apa pun yang diketahui, dan mengembalikan bilah warna yang dikonfigurasi dengan tepat:

# use the field name of the column source
cmap = linear_cmap('counts', palette="Spectral6", low=min(y), high=max(y))

r = p.scatter(x='x', y='y', color=cmap, size=15, source=source)

# automatically create a color bar from the scatter glyph renderer
color_bar = r.construct_color_bar(width=10)

Bokeh 3.1 akan tersedia melalui semua saluran reguler segera setelah dirilis. Dalam banyak kasus, Anda dapat menjalankan salah satu conda install bokehatau pip install bokeh.

Jika Anda ingin memastikan bahwa Anda segera mendapatkan versi terbaru yang tersedia, Anda juga dapat menginstal langsung dari saluran Bokeh di anaconda.org , menggunakan conda install -c bokeh bokeh.

Untuk informasi selengkapnya tentang memasang Bokeh, lihat bagian Detail penginstalan di dokumentasi Bokeh .

Langkah selanjutnya

Jika Anda memiliki pertanyaan, kami mendorong Anda untuk mengunjungi Wacana Bokeh ! Pengelola proyek yang ramah dan komunitas pengguna Bokeh siap membantu Anda menavigasi masalah apa pun yang muncul.

Pengembang yang tertarik untuk terlibat dapat mengunjungi panduan kontributor untuk mendapatkan panduan tentang praktik terbaik, pertimbangan teknis, dan cara memulai.

Seperti biasa, kami menghargai umpan balik bijaksana dari pengguna dan terutama kerja komunitas kontributor kami untuk menjadikan Bokeh lebih baik!