Manual de uso · versión 1.0.12

Manual de Farven Calc

Todo lo que hace la aplicación y cómo se escribe: la hoja como memoria de cálculo, la sintaxis línea por línea, las unidades físicas, las funciones del motor, las matrices, los condicionales, los gráficos, los resultados FEM de Farven Static y la salida a PDF.

Icono de asociación de archivo de Farven Calc: un documento con la extensión .fcf

.fcf · memoria de cálculo

Índice

Cómo está organizado

Los primeros capítulos explican el uso; los siguientes son la referencia completa de sintaxis, funciones y unidades.

01 · Primeros pasos

Cuenta, interfaz y archivos

Farven Calc es una aplicación de escritorio: el documento vive en el equipo del usuario y la cuenta solo se usa para la licencia.

Cuenta y licencia

Entrar y activar

  • Sin cuenta la aplicación no entra: queda en el inicio de sesión. Se accede con correo y contraseña, enlace mágico o el código que llega por correo.
  • El período de prueba se activa en el portal Farven, con la cuenta; la aplicación solo consulta el estado al iniciar sesión.
  • Los planes son Base, Profesional y Enterprise; el hub de licencias habilita los módulos de cada plan.
  • Ayuda → Licencia muestra el estado, el plan y el vencimiento; Ayuda → Acerca de..., la versión instalada.
La interfaz

Cinta, hoja y paneles

  • La cinta tiene cinco pestañas: Inicio, Edición, Insertar, Configuración y Ayuda.
  • La hoja muestra una línea por afirmación, el resultado con su unidad a la derecha y el error debajo de la línea que lo provoca.
  • La paleta inserta unidades, funciones, matrices y símbolos; los paneles Griegas y Símbolos evitan tipear glifos a mano.
  • La barra de estado reúne el zoom, los avisos dimensionales y el estado de la fuente FEM importada.
  • El tema claro/oscuro se alterna desde Inicio.
Archivos

Abrir, guardar y zoom

  • Nueva, Abrir, Guardar, Guardar como y Recientes trabajan con archivos .fcf locales.
  • La asociación de los .fcf la hace la propia aplicación, sin permisos de administrador.
  • Zoom con Ctrl++, Ctrl+- y Ctrl+0 (100 %), o con el control de la barra de estado.
  • El historial guarda los últimos cambios del documento y se recorre con Ctrl+Z y Ctrl+Y.
02 · El documento

Líneas, asignaciones y estructura

Cada línea de la hoja es una afirmación verificable: una asignación, una hipótesis, una condición o una conclusión. Todo se lee de arriba hacia abajo.

Asignaciones y variables

  • Con := se puede anteponer una descripción libre antes del nombre: solo el último token cuenta como nombre real.
  • Con = el lado izquierdo debe ser exactamente el nombre de la variable.
  • Los nombres admiten letras, números, _, . y |, y un apóstrofo final: λ|_pf, f_u.sol, b'.
  • Los valores pueden ser numéricos o texto entre comillas. Todo lo que sigue a // es comentario.
Ancho de ala b:=200mm
estado:="Ala compacta"
f_u.sol:=70ksi
b':=b/2
// esto es un comentario

Mostrar y formatear resultados

  • Terminar una línea en = muestra el resultado (o el valor actual de una variable ya definida) sin asignar.
  • =unidad fuerza la unidad de salida; @n, pegado a la unidad o solo, fija la cantidad de decimales de esa línea.
b*e=cm²
M=tonf*m@2
k=ksi
t=hr
x=@1

Texto narrativo y subíndices

  • Una línea que empieza con ' es texto libre y nunca se evalúa como fórmula.
  • {nombre} dentro de ese texto muestra el valor actual de la variable, ya formateado.
  • En cualquier nombre, lo que sigue al primer _ se muestra como subíndice: f_y se ve como f con «y» chica.
  • Tab inserta un tabulador real que salta a paradas fijas en milímetros, igual en pantalla y en el PDF.
'La sección tiene un espesor de {e}.

Encabezados, viñetas y saltos de página

  • _#n texto numera secciones de forma jerárquica según el nivel n (1, 2, 3…); el numeral real (1, 1.1, 1.2, 2…) se calcula solo.
  • _#d texto dibuja una viñeta sin numerar, para listar ítems dentro de una sección. El texto es opcional y admite {variable}.
  • _#B corta la página en el lugar donde se escribe; el PDF y la vista en pantalla respetan ese corte.
_#1 Propiedades de la sección
_#2 Verificación de compacidad
_#d Ítem sin numerar
_#B

Listas desplegables

  • lista var1 var2 … declara al menos dos variables: la primera recibe la etiqueta de la opción elegida y las demás, los valores de esa opción en orden.
  • La opción se elige en un desplegable dentro de la hoja y se conserva en el .fcf.

Condicionales: if y showif

  • if cond then … else … endif ejecuta la rama que corresponda; cada rama admite varias líneas y anidamiento a cualquier profundidad.
  • No existe elif: una condición encadenada se escribe como un if anidado dentro del else anterior.
  • También en una línea: if(cond; valor_si; valor_no).
  • showif cond then … endshow usa la misma lógica, pero esconde todo el andamiaje y la rama no tomada: solo se ve el contenido de la rama activa.
  • Dentro de un for … endfor, break corta el bucle y continue salta al siguiente valor.
if λ|_pf <= 0,5 then
  "Ala compacta"
else
  "Ala no compacta"
endif

showif a > 9 then
"No aplica"
else
asigna:= a-9=
endshow
03 · Cálculo

Expresiones, matrices, gráficos e imágenes

Las fórmulas se escriben en notación algebraica común, con coma decimal chilena y punto y coma entre argumentos.

Sintaxis

Operadores

  • Aritmética: +, −, *, /, ^ y paréntesis.
  • También se aceptan los símbolos ×, ·, ÷, −, √, ∞, ≥, ≤ y ≠.
  • Los argumentos de funciones se separan con ; (no con coma). La coma es decimal: 1,5.
  • π se escribe con el símbolo griego y vale lo mismo en cualquier expresión.
Álgebra

Matrices y vectores

  • Se declaran con Nombre:=arr[N] (vector de N elementos) o Nombre:=arr[R x C] (matriz de R filas por C columnas, con la x como separador), con sufijo de unidad opcional.
  • Se accede con {i} para vectores y {i;j} para matrices.
  • Operaciones: det, transpose, inv y solve para sistemas lineales.
  • Las filas y listas también se usan como datos para la estadística (media, desv, mediana, moda, reglin).
Numérico

Solvers y series

  • iter(expresión; var; valor_inicial) resuelve por Newton; iter(expresión; var; inicio; fin) usa bisección.
  • int(expr; var; a; b) integra numéricamente; sum y prod acumulan una expresión en un rango.
  • Todos aceptan magnitudes con unidad: la unidad la fijan los extremos del rango.
iter(sin(x)-0,5; x; 0; 1)   → 0,524
iter(pow(x;2)-2; x; 1)      → 1,414
iter(L-1m; L; 0m; 2m)       → 1 m
Extensión

Funciones y constantes propias

  • Las funciones de usuario se definen desde Configuración con nombre, parámetros y cuerpo; después se usan como cualquier función del motor.
  • Las constantes propias se definen desde Configuración, con o sin unidad, y se usan en cualquier expresión igual que una variable.
  • Las unidades personalizadas se definen a partir de las unidades base y quedan disponibles en toda la aplicación.
Visualización

Gráficos e imágenes

  • Insertar → Gráfico pide la función f(x), la variable independiente, el rango x mínimo y máximo, y un título opcional.
  • El gráfico se dibuja en la hoja y viaja al PDF; se puede editar o eliminar sin tocar el resto de la línea.
  • Insertar → Imagen acepta un archivo o el portapapeles; una imagen existente se puede reemplazar sin perder etiqueta, tamaño ni alineación.
  • Las filas de gráfico e imagen se comportan como el resto del documento al paginar.
Diagnóstico

Errores y avisos

  • El error aparece debajo de la línea que lo provoca, sin romper el resto del documento.
  • Un resultado con dimensiones físicas nunca se muestra como número pelado: si falta la unidad, la app lo avisa y lo deja en la barra de estado.
  • Ayuda → Reportes reúne los avisos locales para diagnóstico.
04 · Funciones

Catálogo del motor

Esta es la lista completa de funciones integradas. Los argumentos se separan con ; y las magnitudes conservan su unidad.

FunciónFirmaQué hace
Aritmética y potencias
sqrtsqrt(x)Raíz cuadrada.
absabs(x)Valor absoluto.
powpow(base; exp)Potencia con exponente explícito.
minmin(a; b)Mínimo de dos valores.
maxmax(a; b)Máximo de dos valores.
log10log10(x)Logaritmo decimal.
lnln(x)Logaritmo natural.
Trigonometría
sinsin(θ)Seno (ángulo en radianes).
coscos(θ)Coseno.
tantan(θ)Tangente.
asinasin(x)Arcoseno.
acosacos(x)Arcocoseno.
atanatan(x)Arcotangente.
atan2atan2(y; x)Arcotangente de dos argumentos (ángulo completo).
sinhsinh(x)Seno hiperbólico.
coshcosh(x)Coseno hiperbólico.
tanhtanh(x)Tangente hiperbólica.
degtoraddegtorad(x)Grados a radianes.
radtodegradtodeg(x)Radianes a grados.
Lógica, integrales y series
ifif(cond; then; else)Función condicional en una línea.
intint(expr; var; a; b)Integración numérica entre dos extremos.
iteriter(expresión; var; valor_inicial)Resuelve una ecuación por Newton.
iteriter(expresión; var; inicio; fin)Resuelve una ecuación por bisección en un rango.
sumsum(expr; var; inicio; fin)Sumatoria finita (Σ).
prodprod(expr; var; inicio; fin)Productoria finita (Π).
Matrices
detdet(A)Determinante de una matriz.
transposetranspose(A)Matriz transpuesta.
invinv(A)Matriz inversa.
solvesolve(A; b)Resuelve el sistema lineal A·x = b.
Estadística
mediamedia(v)Promedio de un vector.
desvdesv(v)Desviación estándar muestral (n−1).
medianamediana(v)Mediana de un vector.
modamoda(v)Valor más frecuente.
reglinreglin(x; y)Regresión lineal: [pendiente; ordenada; r²].
05 · Unidades

Unidades físicas de punta a punta

Cada número puede llevar su unidad. Las operaciones propagan la dimensión y el resultado se muestra con la unidad de trabajo configurada, salvo que la línea pida otra.

MagnitudUnidadesNotas
Longitudkm · m · cm · mm · ft · inBase de la UI: metros; el área usa el sufijo ² (cm², mm²…).
FuerzaN · kN · kgf · tonf · kipklbf y klb son alias de kip.
Tensión / presiónPa · kPa · MPa · GPa · psi · ksiMPa equivale a N/mm².
Tiempos · min · hr · daysec, h y d son alias.
TemperaturaKº · Cº · FºCelsius y Fahrenheit aplican el offset al mostrar.
Eléctricas y energía

Catálogo de ciencias

  • Potencia: W, kW, MW, mW, hp, cv.
  • Energía: J, kJ, MJ, mJ, Wh, kWh, cal, kcal.
  • Frecuencia: Hz, kHz, MHz, GHz.
  • Corriente: A, mA, uA, kA (el token de micro es u; se muestra µA).
  • Carga: C, mC, uC.
  • Tensión: V, mV, uV, kV.
  • Resistencia: ohm, kohm, Mohm (se muestran Ω, kΩ y MΩ).
  • Campo eléctrico: V/m, kV/m, N/C.
Compuestas

Se escriben tal cual

  • kN·m (momento) · kN/m (carga lineal) · N/mm² (tensión).
  • m/s · km/hr (velocidad) · 1/Kº (dilatación térmica).
  • El literal con unidad se convierte solo al sistema interno (SI) y la unidad se propaga por toda la fórmula.
  • Un resultado con dimensiones nunca se muestra sin unidad: la app avisa si falta.
Presentación

Forzar unidad y decimales

  • Terminar en =unidad muestra el resultado en esa unidad: k=ksi, b*e=cm².
  • @n fija los decimales de la línea: M=tonf*m@2, x=@1.
  • Configuración → Unidades define las unidades de trabajo (longitud, fuerza, tensión/presión, tiempo, temperatura) y los decimales por defecto.
  • El compendio de unidades personalizadas se define a partir de las bases y queda disponible en toda la aplicación.
06 · Modelos FEM · Profesional

Resultados de Farven Static

La importación de modelos de Farven Static (.fsf y su .fsr) es una función de la versión Profesional. Con el plan Base el botón existe, pero avisa y no abre el selector de archivos.

Flujo

Importar un modelo

  • Inicio → Importar .fsf abre el selector; si el archivo trae varias hojas, se elige cuál importar.
  • El .fsr homónimo (mismo nombre, extensión .fsr) aporta los resultados. Sin él, el modelo no está evaluado y no se puede importar.
  • Al terminar, el panel de barras y nodos se abre solo: lista las barras con su esfuerzo y los nodos con reacciones y desplazamientos.
  • Si el .fsf no trae hoja de cálculo, se importa igual el modelo y la hoja actual se conserva.
  • Un esquema no soportado se informa con un aviso concreto, sin importar nada a medias.
Referencias

Escribir resultados con @

  • @e1.mu, @e1.fy: esfuerzos y propiedades de la barra e1.
  • @e1.a, @e1.iy, @e1.iz, @e1.sec: área, inercias y tipo de sección.
  • @e1(0,5).mu: valor del diagrama en una posición del largo de la barra.
  • @n1.fy, @n1.ux: reacciones y desplazamientos del nodo.
  • @bmax.N, @bmin.Mw: extremo del esfuerzo en la barra crítica; @bmax.N(50%) lo lee en una posición.
  • @nmax.uy, @nmin.ux: envolvente de nodos.
  • @env("M").E("e1").max: envolvente de momento de una barra.
Panel y alias

Barras, nodos y nombres propios

  • El panel permite ordenar las barras por N, Vv o Mw y hacer clic en una propiedad para insertarla en la fila enfocada.
  • Con @bar01 := @e10 se le da un nombre propio a una barra; después @bar01.a vale lo mismo que @e10.a.
  • Los valores importados se guardan dentro del .fcf: el documento abre e imprime aunque el .fsf ya no esté.
  • Al abrir el documento, la versión Profesional pregunta si actualizar los valores desde el .fsf o mantener los guardados; la Base conserva siempre los guardados.
07 · Impresión y PDF

Del documento al papel

La hoja se pagina en pantalla igual que en el PDF: lo que se ve es lo que sale impreso.

Paginación

Saltos y guías

  • La hoja muestra las guías de salto de página calculadas con el formato elegido.
  • _#B fuerza un corte manual en ese punto; lo anterior se cierra como página.
  • Los gráficos e imágenes se mantienen enteros: si no entran, pasan a la página siguiente.
  • El número de hojas del PDF coincide con las guías de la pantalla.
Salida

PDF y impresión

  • Exportar a PDF genera el documento con la tipografía matemática y las unidades tal como se ven.
  • Imprimir (Ctrl+P) usa el diálogo del sistema con el mismo contenido.
  • Configuración → Impresión fija el formato de hoja, los márgenes, el encabezado y el pie.
  • La marca Farven aparece solo durante el período de prueba; con la suscripción, el PDF sale sin marca.
08 · Atajos

Teclado

Atajos de la hoja y del documento. En macOS, Ctrl se reemplaza por Cmd en guardar.

AtajoAcción
Shift+EnterInsertar una fila debajo de la actual.
Ctrl+ZDeshacer.
Ctrl+Shift+Z / Ctrl+YRehacer.
Ctrl+C · Ctrl+X · Ctrl+VCopiar, cortar y pegar filas o el texto seleccionado.
Ctrl+FBuscar en la hoja.
Ctrl+RBuscar y reemplazar.
Ctrl+S · Ctrl+Shift+SGuardar y guardar como.
Ctrl+PImprimir.
Ctrl+GConvertir la letra anterior en su griega (α, β, …).
Ctrl+MConvertir la letra anterior en símbolo matemático (r→√, i→∞, x→×, v→÷, m→·, d→ϕ).
Ctrl++ · Ctrl+- · Ctrl+0Zoom de visualización: acercar, alejar y volver al 100 %.
TabTabulador real alineado a la regla de milímetros.
09 · Archivos y planes

Formatos, versiones y soporte

Formatos

Qué abre y qué guarda

  • .fcf: documento nativo de Farven Calc. Guarda la hoja, las unidades, los gráficos, las imágenes y los valores FEM importados.
  • .fsf + .fsr: modelo de Farven Static y sus resultados; se importan como modelo (Profesional).
  • PDF: salida para anexar al informe o a la memoria del proyecto.
  • Los documentos viven en el equipo del usuario: no hay nube ni sincronización en la versión Base.
Versiones

Base, Profesional y Enterprise

  • Base: cálculo con unidades, funciones, matrices, condicionales, gráficos, imágenes, PDF e impresión.
  • Profesional: suma la importación de resultados de Farven Static (.fsf/.fsr) y el panel de barras y nodos.
  • Enterprise: módulos adicionales detrás del mismo gate de licencia.
  • El plan se contrata y se cambia en el portal Farven; la aplicación solo consulta el estado.
Soporte

Ayuda dentro de la app

  • Ayuda → Referencia: sintaxis y ejemplos abribles como documento nuevo.
  • Ayuda → Acerca de...: versión instalada.
  • Ayuda → Buscar actualizaciones: comprueba el manifiesto oficial y ofrece la descarga.
  • Ayuda → Contacto y la sección de soporte de la landing.