ffc - Online di Cloud

PROGRAM:

NAMA

FFC - Kompilator Formulir FEniCS

RINGKASAN

FFC [-h] [-V] [-v] [-s] [-e] [-l bahasa] [-r representasi] [-f opsi] [-O] [-q
aturan segi empat] ... input.ufl ...

DESKRIPSI

Kompilasi formulir multilinear menjadi kode tingkat rendah yang efisien.

FEniCS Form Compiler FFC menerima sebagai input satu atau lebih file, masing-masing menentukan satu atau
lebih banyak bentuk multilinear, dan mengkompilasi formulir yang diberikan ke dalam kode tingkat rendah yang efisien untuk
perakitan otomatis tensor yang mewakili bentuk multilinear. Secara khusus, FFC
mengkompilasi sepasang bentuk bilinear dan linier yang mendefinisikan masalah variasi ke dalam kode yang
dapat digunakan untuk merakit sistem linier yang sesuai secara efisien.

Secara default, FFC menghasilkan kode sesuai dengan spesifikasi UFC versi 1.0 (Unified
Kode Perakitan Formulir, lihat http://www.fenics.org/) tetapi ini dapat dikontrol dengan menentukan a
bahasa keluaran yang berbeda (opsi -l). Dimungkinkan juga untuk menambahkan bahasa keluaran baru ke
FFC.

Untuk deskripsi lengkap FFC, termasuk spesifikasi bahasa formulir yang digunakan untuk
menentukan bentuk multilinear, lihat manual pengguna FFC yang tersedia di halaman web FEniCS:
http://www.fenics.org/

PILIHAN

-h, --membantu
Tampilkan teks bantuan dan keluar.

-V, --Versi: kapan
Tampilkan nomor versi dan keluar.

-v, --bertele-tele
Mode verbose, lebih banyak output dicetak. Konflik dengan -s.

-s, --diam
Mode senyap, tidak ada output yang dicetak. Konflik dengan -v.

-e, --kontrol-kesalahan
Mode kontrol kesalahan, satu set formulir tambahan yang berguna untuk kesalahan berorientasi tujuan
kontrol dihasilkan dan dikompilasi.

-l bahasa, --bahasa bahasa
Tentukan bahasa keluaran, salah satu dari 'ufc' (default) atau 'dolfin' (UFC dengan lapisan kecil
pengikatan khusus DOLFIN).

-r perwakilan, --perwakilan perwakilan
Tentukan representasi untuk prakomputasi dan pembuatan kode, salah satu dari 'quadrature'
(default) atau 'tensor'.

-f Option
Tentukan opsi pembuatan kode. Daftar opsi yang tersedia tergantung pada
bahasa tertentu (format). Pilihan saat ini termasuk -fblas, -fno-foo,
-fpresisi=n, -fprecompute_basis_const, -fprecompute_ip_const,
-fsimplify_expressions, -feminate_zeros, -fquadrature_degree=n dan, -fsplit,
-fno_ferari, dijelaskan secara rinci di bawah ini.

-f blas
Buat kode yang menggunakan BLAS untuk menghitung produk tensor. Opsi ini saat ini
diabaikan, tetapi dapat digunakan untuk mengurangi ukuran kode ketika opsi BLAS adalah
(kembali) diimplementasikan di versi mendatang.

-f tidak-foo
Jangan buat kode untuk fungsi UFC dengan nama 'foo'. Pilihan umum termasuk -fno-
evaluasi_dasar dan -fno-evaluate_basis_derivatives untuk memperkecil ukuran
kode yang dihasilkan ketika fungsi-fungsi ini tidak diperlukan.

-f presisi = n
Atur jumlah digit signifikan menjadi n dalam kode yang dihasilkan. Nilai default
dari n adalah 15.

-f precompute_basis_const
Opsi pengoptimalan untuk representasi kuadratur. Opsi ini diabaikan jika
optimasi tidak digunakan (lihat -O pilihan), dan itu juga menyiratkan
-fprecompute_ip_const Option. Opsi ini akan menghasilkan kode yang memperhitungkan istilah sebelumnya
yang konstan dalam loop yang melibatkan indeks dasar. Hal ini dapat mengakibatkan
pengurangan jumlah operasi dan dengan demikian meningkatkan efisiensi runtime dari
kode yang dihasilkan. Namun, peningkatannya tergantung pada opsi kompiler GCC sebagai
serta karakteristik bentuk variasi.

-f precompute_ip_const
seperti -fprecompute_basis_const opsi dengan satu-satunya perbedaan kode itu adalah
dihasilkan untuk menghitung istilah yang konstan dalam loop yang melibatkan
titik integrasi saja.

-f menyederhanakan_ekspresi
Opsi pengoptimalan untuk representasi kuadratur. Opsi ini diabaikan jika
optimasi tidak digunakan (lihat -O pilihan). Sebelum menyederhanakan ekspresi menjadi
menghitung tensor elemen lokal, mereka diperluas untuk mengidentifikasi dan
menghitung suku-suku yang konstan sehubungan dengan geometri dan integrasi
poin. Operasi ini bisa sangat mahal karena melibatkan banyak pembuatan baru
istilah-istilah yang mungkin mengakibatkan memori habis.

-f hilangkan_nol
Opsi pengoptimalan untuk representasi kuadratur. Opsi ini diabaikan jika
optimasi tidak digunakan (lihat -O pilihan). Tabel yang berisi nilai fungsi dasar
akan dikompresi sehingga hanya berisi nilai bukan nol. Ini akan mengurangi
rentang loop dan dengan demikian jumlah operasi, tetapi karena pemetaan adalah
diperkenalkan, untuk memasukkan nilai dengan benar ke dalam matriks elemen, beberapa
overhead diperkenalkan. Opsi pengoptimalan ini biasanya paling efektif dalam
kombinasi dengan salah satu opsi pengoptimalan lainnya.

-f kuadrat_derajat=n
Akan menghasilkan aturan kuadratur yang akurat hingga derajat n terlepas dari
derajat polinomial bentuk. Opsi ini hanya berlaku untuk formulir UFL dan
gelar yang ditentukan akan berlaku untuk SEMUA persyaratan dari formulir yang diberikan yang tidak dimiliki gelar
telah ditentukan melalui metadata! Sebagai FFC default akan menentukan derajat
otomatis dari formulir.

-f membagi
Hasilkan file terpisah untuk deklarasi dan implementasinya.

-f no_ferari
Lewati optimasi FErari, bahkan jika flag -O disetel. Ini hanya berpengaruh ketika
representasi tensor digunakan. Opsi ini dapat digunakan dalam kombinasi dengan
-O tandai untuk menghindari waktu kompilasi yang berpotensi sangat lama dengan menginstruksikan FFC hanya
mengoptimalkan ketika representasi kuadratur digunakan.

-O, --optimalkan
Hasilkan kode yang dioptimalkan dengan jumlah operasi yang lebih rendah dibandingkan dengan kode yang tidak dioptimalkan
untuk perakitan tensor elemen lokal. Hal ini secara umum akan meningkatkan
kinerja run-time dari kode. Jika representasi (lihat -r opsi) adalah 'tensor'
maka FFC akan menggunakan optimasi FErari. Opsi ini membutuhkan FErari dan harus
digunakan dengan hati-hati karena mungkin sangat mahal (pada waktu kompilasi) untuk selain
bentuk-bentuk sederhana. Jika representasinya adalah 'kuadrat', waktu kompilasi meningkat
cenderung jauh kurang drastis dibandingkan dengan FErari untuk bentuk yang sangat kompleks. NS -O
opsi untuk representasi kuadratur mengaktifkan tanda pengoptimalan berikut:

-fsimplify_expressions -feminate_zeros

-o direktori, --output-direktori direktori
Tentukan direktori tempat file yang dihasilkan harus ditulis. Standarnya
direktori keluaran adalah direktori saat ini ('.').

-q aturan, --aturan-kuadrat memerintah
Tentukan aturan kuadratur yang harus digunakan saat mengintegrasikan formulir. Ini
akan mempengaruhi representasi tensor dan kuadratur. Saat ini, opsi yang tersedia
adalah 'default' dan 'kanonik'. Opsi 'default' mencakup penerapan tangan
aturan kuadratur untuk segitiga dan tetrahedra dengan tingkat presisi kurang dari
atau sama dengan enam. Opsi 'kanonik' bergantung pada FIAT untuk menghitung kuadratur
aturan yang didasarkan pada Gauss--Legendre--aturan Jacobi yang dipetakan ke simplis. Oleh
default, FFC akan mencoba menggunakan opsi 'default' karena ini biasanya akan menghasilkan
kode paling efisien yang dihasilkan. Jika ini tidak mungkin (jika polinomial
derajat integran lebih besar dari enam, atau jika sel bukan salah satu dari 'segitiga'
atau 'tetrahedron'), FFC akan secara otomatis menerapkan aturan 'kanonik'. Jika nomor
titik integrasi yang digunakan oleh aturan 'kanonik' terlalu besar untuk efisien
perhitungan, opsi -fquadrature_degree dapat digunakan.

BUG

Kirim komentar, pertanyaan, laporan bug, dll. ke [email dilindungi].

Gunakan ffc online menggunakan layanan onworks.net