ffc - Online en la nube

PROGRAMA:

NOMBRE

FFC: el compilador de formularios FEniCS

SINOPSIS

FFC [-h] [-V] [-v] [-s] [-e] [-l idioma] [-r representación] [-f opción] [-O] [-q
regla de cuadratura] ... input.ufl ...

DESCRIPCIÓN

Compile formularios multilineales en código eficiente de bajo nivel.

El FFC del compilador de formularios FEniCS acepta como entrada uno o más archivos, cada uno especificando uno o más
formas más multilineales, y compila las formas dadas en un código eficiente de bajo nivel para
montaje automático de los tensores que representan las formas multilineales. En particular, FFC
compila un par de formas bilineales y lineales que definen un problema variacional en un código que
se puede utilizar para ensamblar eficientemente el sistema lineal correspondiente.

De forma predeterminada, FFC genera código de acuerdo con la especificación UFC versión 1.0 (Unified
Código de ensamblaje de forma, consulte http://www.fenics.org/) pero esto se puede controlar especificando un
idioma de salida diferente (opción -l). También es posible agregar nuevos idiomas de salida a
FFC.

Para obtener una descripción completa de FFC, incluida una especificación del lenguaje de formularios utilizado para
definir las formas multilineales, consulte el manual de usuario de FFC disponible en la página web de FEniCS:
http://www.fenics.org/

OPCIONES

-h, --ayuda
Mostrar texto de ayuda y salir.

-V, --versión
Muestra el número de versión y sale.

-v, --verboso
Modo detallado, se imprime más salida. Conflictos con -s.

-s, --silencio
Modo silencioso, no se imprime ninguna salida. Conflictos con -v.

-e, - control de errores
Modo de control de errores, un conjunto de formularios adicionales útiles para errores orientados a objetivos
se genera y se compila el control.

-l idioma, --idioma idioma
Especifique el idioma de salida, uno de 'ufc' (predeterminado) o 'dolfin' (UFC con una capa pequeña
de enlaces específicos de DOLFIN).

-r representación, --representación representación
Especificar representación para precomputación y generación de código, una de 'cuadratura'
(predeterminado) o 'tensor'.

-f opción
Especifique las opciones de generación de código. La lista de opciones disponibles depende del
idioma (formato) especificado. Las opciones actuales incluyen -fblas, -fno-foo,
-fprecisión = n, -fprecompute_basis_const, -fprecompute_ip_const,
-fsimplificar_expresiones, -feliminar_ceros, -fcuadrature_degree = n y, -fdividir,
-fno_ferari, descrito en detalle a continuación.

-f blas
Genere código que use BLAS para calcular productos tensoriales. Esta opción es actualmente
ignorado, pero se puede utilizar para reducir el tamaño del código cuando la opción BLAS está
(re) implementado en versiones futuras.

-f no-foo
No genere código para la función UFC con el nombre 'foo'. Las opciones típicas incluyen -fno-
evaluar_basis y -fno-evaluar_derivados_basis para reducir el tamaño de la
código generado cuando estas funciones no son necesarias.

-f precisión = n
Establezca el número de dígitos significativos an en el código generado. El valor predeterminado
de n es 15.

-f precompute_basis_const
Opción de optimización para la representación en cuadratura. Esta opción se ignora si
la optimización no se utiliza (ver -O opción), y también implica la
-fprecompute_ip_const opción. Esta opción generará código que precalcula los términos
que son constantes en los bucles que involucran índices básicos. Esto puede resultar en una
reducción del recuento de operaciones y, por lo tanto, mejorar la eficiencia del tiempo de ejecución del
código generado. Sin embargo, las mejoras dependen de las opciones del compilador GCC como
así como las características de la forma variacional.

-f precompute_ip_const
Como en el -fprecompute_basis_const opción con la única diferencia de que el código será
generado para calcular términos que son constantes en los bucles que involucran
puntos de integración solamente.

-f simplificar_expresiones
Opción de optimización para la representación en cuadratura. Esta opción se ignora si
la optimización no se utiliza (ver -O opción). Antes de simplificar las expresiones a
calcular el tensor del elemento local, se expanden para identificar y
precalcular términos que son constantes con respecto a la geometría y la integración
puntos. Esta operación puede resultar muy costosa ya que implica la creación de muchos
términos que pueden resultar en el agotamiento de la memoria.

-f eliminar_zeros
Opción de optimización para la representación en cuadratura. Esta opción se ignora si
la optimización no se utiliza (ver -O opción). Tablas que contienen valores de función base
se comprimirán de modo que solo contengan valores distintos de cero. Esto reducirá
los rangos de bucle y, por lo tanto, el número de operaciones, pero dado que un mapeo es
introducido, con el fin de insertar valores correctamente en la matriz de elementos, algunos
se introduce la sobrecarga. Esta opción de optimización suele ser más eficaz en
combinación con una de las otras opciones de optimización.

-f grado_cuadratura = n
Generará una regla de cuadratura precisa hasta el grado n independientemente de la
grado polinómico de la forma. Esta opción solo es válida para formularios UFL y el
El título especificado se aplicará a TODOS los términos del formulario dado para los que no se ha obtenido ningún título.
ha sido especificado a través de metadatos! Por defecto, FFC determinará el grado
automáticamente desde el formulario.

-f split
Genere archivos separados para las declaraciones y la implementación.

-f no_ferari
Omita las optimizaciones de FErari, incluso si se establece el indicador -O. Esto solo tiene efecto cuando
se utiliza la representación tensorial. Esta opción se puede utilizar en combinación con el
-O flag para evitar tiempos de compilación potencialmente muy largos indicando a FFC que solo
optimizar cuando se utiliza la representación en cuadratura.

-O, --optimizar
Genere código optimizado con un recuento de operaciones menor en comparación con el código no optimizado
para el ensamblaje del tensor del elemento local. En general, esto aumentará la
rendimiento del código en tiempo de ejecución. Si la representación (ver -r opción) es 'tensor'
entonces FFC utilizará optimizaciones de FErari. Esta opción requiere FErari y debe ser
se usa con precaución ya que puede ser muy costoso (en tiempo de compilación) para otros
formas simples. Si la representación es 'cuadratura', el tiempo de compilación aumenta
tiende a ser mucho menos drástico en comparación con FErari para formas muy complejas. los -O
La opción de representación en cuadratura activa los siguientes indicadores de optimización:

-fsimplificar_expresiones -feliminar_ceros

-o directorio, --directorio de salida directorio
Especifique el directorio donde se deben escribir los archivos generados. El valor por defecto
El directorio de salida es el directorio actual ('.').

-q regla, - regla de cuadratura gobernar
Especifique la regla de cuadratura que debe usarse al integrar las formas. Esta
afectará tanto a la representación tensorial como a la cuadratura. Actualmente, opciones disponibles
son 'predeterminados' y 'canónicos'. La opción 'predeterminada' cubre la implementación manual
reglas de cuadratura para triángulos y tetraedros con un grado de precisión menor que
o igual a seis. La opción 'canónica' se basa en FIAT para calcular la cuadratura
regla que se basa en la regla de Gauss-Legendre-Jacobi mapeada en simplices. Por
predeterminado, FFC intentará utilizar la opción 'predeterminada', ya que esto normalmente resultará en
el código más eficiente que se genera. Si esto no es posible (si el polinomio
grado del integrando es mayor que seis, o si la celda no es una de 'triángulo'
o 'tetraedro'), FFC aplicará automáticamente la regla 'canónica'. Si el numero
de los puntos de integración utilizados por la regla 'canónica' es demasiado grande para
computación, la opción -fcuadrature_degree puede ser usado.

LOCO

Envíe comentarios, preguntas, informes de errores, etc. a [email protected].

Use ffc en línea usando los servicios de onworks.net