//
// A simple CAS arithmetic and algebra checker using Algebrite.
// Importing this file installs a new validation
// tool called "CAS".
//
import { Expression } from '../expression.js'
import { Symbol as LurchSymbol } from '../symbol.js'
import Algebrite from '../../dependencies/algebrite.js'
// All Algebrite mathematical operators
const allOps = [
'+' , '-' , '*' , '/' ,
'^' , 'mod' , 'abs' , 'adj' ,
'and' , 'arccos' , 'arccosh' , 'arcsin' ,
'arcsinh' , 'arctan' , 'arctanh' , 'arg' ,
'besselj' , 'bessely' , 'ceiling' , 'choose' ,
'circexp' , 'coeff' , 'cofactor' , 'conj' ,
'contract' , 'cos' , 'cosh' , 'cross' ,
'curl' , 'd' , 'defint' , 'deg' ,
'denominator', 'det' , 'dim' , 'dot' ,
'eigen' , 'eigenval' , 'eigenvec' , 'erf' ,
'erfc' , 'eval' , 'exp' , 'expand' ,
'expcos' , 'expsin' , 'factor' , 'factorial' ,
'filter' , 'float' , 'floor' , 'gcd' ,
'hermite' , 'hilbert' , 'imag' , 'inner' ,
'integral' , 'inv' , 'laguerre' , 'lcm' ,
'leading' , 'legendre' , 'log' , 'not' ,
'nroots' , 'numerator' , 'or' , 'outer' ,
'polar' , 'prime' , 'product' , 'quotient' ,
'rank' , 'rationalize', 'real' , 'rect' ,
'roots' , 'shape' , 'simplify' , 'sin' ,
'sinh' , 'sqrt' , 'subst' , 'sum' ,
'tan' , 'tanh' , 'taylor' , 'transpose' ,
'unit' , 'zero' , '=' , '==' ,
'>' , '<' , '>=' , '<=' ,
'isprime'
]
// All operators are prefix unless listed here
const infixOps = ['+','-','*','/','^','=','==','>','<','>=','<=']
// These are the relation operators
const relationOps =
['=','==','>','<','>=','<=','isprime']
// string formatting utilities
const infix = (operator) => { return (x,y)=>`(${x})${operator}(${y})`}
const prefix = (operator) => { return (...args)=>`${operator}(${args})`}
// Treats the given expression as an Algebrite expression, and produce
// a string suitable for input to Algebrite. An error is thrown if the
// input is anything other than nested application of the operators in
// the above table, with the appropriate arities, to atomic values stored
// as symbols and converted to strings.
//
// This routine assumes expression is an LC expression
const toAlgebrite = ( expression ) => {
// convert symbols to a string
if ( expression instanceof LurchSymbol ) { return `${expression}`}
// get the operator
const operator = expression.firstChild()
// is it a symbol
if ( !( operator instanceof LurchSymbol ) )
throw new Error( 'Operators must be symbols' )
// convert the symbol to a string
const op = operator.text()
// is it an Algebrite operator
if ( !allOps.includes( op ) )
throw new Error( 'Not a supported operator: ' + operator.text() )
// get the operands
const operands = expression.allButFirstChild()
// get the map to apply this operator to its operands
let toApply
// negation is special
if (op==='-') {
toApply = (operands.length===1) ? x=>`-(${x})` : infix(op)
// check for infix
} else if (infixOps.includes(op)) {
toApply = infix(op)
// everything else is prefix
} else {
toApply = prefix(op)
}
return toApply.apply( null, operands.map( toAlgebrite ) )
}
// use Algebrite to evaluate the given expression
// It must be an equation, inequality, or isprime(n) where
// n is an integer expression
const runCAS = ( expression ) => {
// make sure the argument is an Expression
if ( !( expression instanceof Expression ) )
throw new Error('CAS supports only Expressions' )
// we only allow relations for now
const op = expression.firstChild().text()
if ( !relationOps.includes(op) )
throw new Error('CAS only validates equations, inequalities, and isprime.')
return Algebrite.run( `check(${toAlgebrite(expression)})` )
}
// a validation tool (as documented in the tools.js file) that uses the above
// function to do validation of expressions that are supported by Algebrite
// Currently returns 0 for false and 1 for true.
/**
* The {@link Validation Validation} module provides a framework for installing
* and using a collection of Validation Tools. This virtual namespace documents
* them all in one place.
*
* **Validation Tools**
* - [CAS]{@link ValidationTools.CASValidator}
* - [floating point arithmetic]{@link ValidationTools.arithmeticValidator}
* - [Classical Propositional Logic]{@link
* ValidationTools.classicalPropositionalValidator}
* - [Intuitionistic Propositional Logic]{@link
* ValidationTools.intuitionisticPropositionalValidator}
* @namespace ValidationTools
*/
/**
* The CAS Validation Tool uses
* <a href='http://algebrite.org' target='blank'>Algebrite</a> to evaluate
* whether an equation, inequality, or the statement `isprime(n)` is valid.
* It can be applied to a single {@link Expression}, and will mark it valid
* if and only if the expression is a valid Algebrite equation, inequality,
* or the statement `isprime(n)` where $n$ is an expression that evaluates
* to an integer, and the Algebrite `check(expression)` command returns `1`.
*
* @memberof ValidationTools
* @param {Expression} expression - An {@link Expression} that represents
* a valid Algebrite equation, inequality, or the statement `isprime(n)`.
* @see {@link module:Validation Validation}
*/
const CASValidator = ( expression/*, options */ ) => {
try {
let value = runCAS(expression)
return {
result : (value==='1')?'valid':'invalid',
reason : 'CAS',
value : value
}
} catch ( error ) {
return {
result : 'invalid',
reason : 'Invalid CAS expression',
message : error.message
}
}
}
export { CASValidator }
source