jlFriCAS

FriCAS is a general purpose computer algebra system (CAS).

In this work-in-progress repository, a C wrapper using libjulia is embedded in FriCAS to support some Julia based specific operations (for example, system optimized BLAS and LAPACK libraries). The build process supports Clozure CL and SBCL, but only Julia 1.10.0 and Julia 1.11.* are supported with SBCL, see Caveats. It must not be considered production-ready.

Building and Installing

For general installation instructions see INSTALL. For general documentation consult https://fricas.github.io.

To build FriCAS with Julia support, the julia executable needs to be available in your PATH, and a simple ./configure --enable-julia should do the trick. The required Julia packages are Suppressor, Nemo and SpecialFunctions.

As of now with Clozure CL queues is also required. Use installed quicklisp with queues, and at configure time use the --with-quicklisp option, see the quicklisp documentation for how to load it and install queues.

If you want to visualize your data using Julia, small support is provided using StatsPlots and eventually LaTeXStrings Julia packages.

If you want to use jFriCAS i.e. Jupyter support for FriCAS built with SBCL, make sure hunchentoot is installed. On a Debian like system you can add hunchentoot with sudo apt install cl-hunchentoot and issue, for example, ./configure --enable-gmp --enable-julia --enable-hunchentoot.

To know which categories/domains/packages are added to FriCAS issue in the FriCAS interpreter )what things julia and/or )what things nemo or use HyperDoc:

(1) -> )what things julia

Operations whose names satisfy the above pattern(s):

juliaCMPrint    juliaCVPrint    juliaIVPrint    juliaMPrint     
juliaVPrint     
   
      To get more information about an operation such as juliaCMPrint ,
      issue the command )display op juliaCMPrint 
------------------------------- Categories --------------------------------

Categories with names matching patterns:
     julia 

 JARBPR   JuliaArbitraryPrecision      JMATCAT  JuliaMatrixCategory
 JOBJTYP  JuliaObjectType              JRING    JuliaRing
 JTYPE    JuliaType                    JVECCAT  JuliaVectorCategory
 JWS      JuliaWolframSymbolic
--------------------------------- Domains ---------------------------------

Domains with names matching patterns:
     julia 

 JCF64    JuliaComplexF64              JCF64MAT JuliaComplexF64Matrix
 JCF64SMA JuliaComplexF64SquareMatrix  JCF64VEC JuliaComplexF64Vector
 JCFLOAT  JuliaComplexFloat            JDFRAME  JuliaDataFrame
 JF64     JuliaFloat64                 JF64MAT  JuliaFloat64Matrix
 JF64SMAT JuliaF64SquareMatrix         JF64VEC  JuliaFloat64Vector
 JFLOAT   JuliaFloat                   JI64     JuliaInt64
 JI64VEC  JuliaInt64Vector             JMATRIX  JuliaMatrix
 JOBJECT  JuliaObject                  JOBJTYP- JuliaObjectType&
 JSTR     JuliaString                  JSYM     JuliaSymbol
 JVECTOR  JuliaVector                  JWS-     JuliaWolframSymbolic&
 JWSAPCPX JuliaWSAPComplex             JWSAPR   JuliaWSAPReal
 JWSCPLX  JuliaWSComplex               JWSEXPR  JuliaWSExpression
 JWSGINT  JuliaWSGaussianInteger       JWSINT   JuliaWSInteger
 JWSRAT   JuliaWSRational              JWSREAL  JuliaWSReal
 JWSSYM   JuliaWSSymbol
-------------------------------- Packages ---------------------------------

Packages with names matching patterns:
     julia 

 JCF64MTF JuliaComplexF64MatrixTranscendentalFunctions
 JCFSF    JuliaComplexFloatSpecialFunctions
 JCLA     JuliaComplexLinearAlgebra    JDRAW    JuliaDrawFunctions
 JF64MTF  JuliaF64MatrixTranscendentalFunctions
 JF64SF   JuliaFloat64SpecialFunctions
 JF64SF2  JuliaFloat64SpecialFunctions2
 JF64VEC2 JuliaFloat64VectorFunctions2  JFSF     JuliaFloatSpecialFunctions
 JFSF2    JuliaFloatSpecialFunctions2  JPLOT    JuliaPlotFunctions
 JRLA     JuliaRealLinearAlgebra       JUF      JuliaUtilityFunctions
 JVECTOR2 JuliaVectorFunctions2
--------------- System Commands for User Level: development ---------------

System commands at this level matching patterns:
     julia

julia     juliad jlapropos jldoc

------------------------- System Command Synonyms -------------------------

 )ju ............................ )julia
 )jud ........................... )juliad

Nemo Categories/Domains (JuliaObject):

(1) -> )what things nemo

   There are no operations containing those patterns

------------------------------------------------ Categories ------------------------------------------------

Categories with names matching patterns:
     nemo

 NRING    NemoRing                                      NTYPE    NemoType
------------------------------------------------- Domains --------------------------------------------------

Domains with names matching patterns:
     nemo

 NAN      NemoAlgebraicNumber                           NCB      NemoComplexBall
 NCF      NemoComplexField                              NECF     NemoExactComplexField
 NFF      NemoFiniteField                               NFR      NemoFactored
 NINT     NemoInteger                                   NMP      NemoMultivariatePolynomial
 NPF      NemoPrimeField                                NRAT     NemoRational
 NRB      NemoRealBall                                  NRF      NemoRealField
 NUP      NemoUnivariatePolynomial                      NZMOD    NemoIntegerMod

If you want to build and install the HTML documentation, you need to install Sphinx. On a Debian like system, to add it, issue in a terminal sudo apt install python3 python3-pip && pip3 install -U Sphinx. After building FriCAS, and before the installation, issue in your terminal make htmldoc.

Description

The basic goal of FriCAS is to create a free advanced world-class CAS. In 2007 FriCAS forked from Axiom. Currently the FriCAS algebra library is one of the largest and most advanced free general purpose computer algebra systems -- this gives a good foundation to build on. Additionally, the FriCAS algebra library is written in a high level strongly typed language (Spad), which allows natural expression of mathematical algorithms. This makes FriCAS easier to understand and extend.

FriCAS uses lightweight development methodology. Compared to Axiom, FriCAS is significantly restructured -- it is more portable and fixed several defects. FriCAS removed rather large unused parts (without removing functionality).

Goals

Current development goals:

• continue structural improvements
• add new mathematical algorithms
• develop better user interface
• develop improved Spad compiler
• make it easier for external programs to interface with FriCAS
• support for using external mathematical routines from Spad

Caveats

Julia support with FriCAS built with SBCL is/was erratic, depending on the Julia version used and the loaded libraries by Julia. The 1.10.0 version seems to have solved some issues related to memory management interactions with SBCL, but with Julia 1.10.1 and 1.10.2 some problems occur again. Note that with Julia 1.11.0-* and later, FriCAS seems to work fine again. More work needs to be done in this regard. So, if you use SBCL to build FriCAS, imperatively use a version of Julia that is known to be compatible.