Please note that FeenoX is a cloud-first back end aimed at advanced users. It does not include a graphical interface and it is not expected to run in Windows. See this 5-min explanation about why:

For an easy-to-use web-based front end with FeenoX running in the cloud directly from your browser see either * CAEplex * SunCAE

Any contribution to make desktop GUIs such as PrePoMax or FreeCAD to work with FeenoX are welcome.

1 Debian/Ubuntu install

sudo apt install feenox

See these links for details about the packages:

2 Downloads

Debian package	https://packages.debian.org/unstable/science/feenox
Ubuntu package	https://launchpad.net/ubuntu/+source/feenox
GNU/Linux binaries	https://www.seamplex.com/feenox/dist/linux
Source tarballs	https://www.seamplex.com/feenox/dist/src
Github repository	https://github.com/seamplex/feenox/

Generic GNU/Linux binaries are provided as statically-linked executables for convenience. They do not support MUMPS nor MPI and have only basic optimization flags. Please compile from source for high-end applications. See detailed compilation instructions.

Be aware that FeenoX does not have a GUI. Read the documentation, especially the description and the FAQs. Ask for help on the GitHub discussions page if you do now understand what this means.

You can still use FeenoX through a web-based UI through SunCAE.

2.1 Statically-linked binaries

Browse to https://www.seamplex.com/feenox/dist/ and check what the latest version for your architecture is. Then do

feenox_version=1.1
wget -c https://www.seamplex.com/feenox/dist/linux/feenox-v${feenox_version}-linux-amd64.tar.gz
tar xzf feenox-v${feenox_version}-linux-amd64.tar.gz
sudo cp feenox-v${feenox_version}-linux-amd64/bin/feenox /usr/local/bin

You’ll have the binary under bin and examples, documentation, manpage, etc under share. Copy bin/feenox into somewhere in the PATH and that will be it. If you are root, do

sudo cp feenox-v${feenox_version}-linux-amd64/bin/feenox /usr/local/bin

If you are not root, the usual way is to create a directory $HOME/bin and add it to your local path. If you have not done it already, do

mkdir -p $HOME/bin
echo 'expot PATH=$PATH:$HOME/bin' >> .bashrc

Then finally copy bin/feenox to $HOME/bin

cp feenox-v${feenox_version}-linux-amd64/bin/feenox $HOME/bin

Check if it works by calling feenox from any directory (you might need to open a new terminal so .bashrc is re-read):

$ feenox
FeenoX v1.1-g94ddf72 
a cloud-first free no-fee no-X uniX-like finite-element(ish) computational engineering tool

usage: feenox [options] inputfile [replacement arguments] [petsc options]

  -h, --help         display options and detailed explanations of command-line usage
  -v, --version      display brief version information and exit
  -V, --versions     display detailed version information
  -c, --check        validates if the input file is sane or not
  --pdes             list the types of PROBLEMs that FeenoX can solve, one per line
  --elements_info    output a document with information about the supported element types
  --ast              dump an abstract syntax tree of the input
  --linear           force FeenoX to solve the PDE problem as linear
  --non-linear       force FeenoX to solve the PDE problem as non-linear

Run with --help for further explanations.
$

2.2 Compile from source

To compile the source tarball, proceed as follows. This procedure does not need git nor autoconf but a new tarball has to be downloaded each time there is a new FeenoX version.

Install mandatory dependencies
```
sudo apt-get update
sudo apt-get install gcc make libgsl-dev
```
If you cannot install libgsl-dev, you can have the configure script to download and compile it for you. See point 4 below.
Install optional dependencies (of course these are optional but recommended)
```
sudo apt-get install libsundials-dev petsc-dev slepc-dev
```
Download and un-compress FeenoX source tarball. Browse to https://www.seamplex.com/feenox/dist/src/ and pick the latest version:
```
wget https://www.seamplex.com/feenox/dist/src/feenox-v1.1.tar.gz
tar xvzf feenox-v1.1.tar.gz
```
Configure, compile & make
```
cd feenox-v1.1
./configure
make -j4
```
If you cannot (or do not want) to use libgsl-dev from a package repository, call configure with --enable-download-gsl:
```
./configure --enable-download-gsl
```
If you do not have Internet access, get the tarball manually, copy it to the same directory as configure and run again.
Run test suite (optional)
```
make check
```
Install the binary system wide (optional)
```
sudo make install
```

2.3 Github repository

The Git repository has the latest sources repository. To compile, proceed as follows. If something goes wrong and you get an error, do not hesitate to ask in FeenoX’s discussion page.

If you do not have Git or Autotools, download a source tarball and proceed with the usual configure & make procedure. See these instructions.

Install mandatory dependencies
```
sudo apt-get update
sudo apt-get install git build-essential make automake autoconf libgsl-dev
```
If you cannot install libgsl-dev but still have git and the build toolchain, you can have the configure script to download and compile it for you. See point 4 below.
Install optional dependencies (of course these are optional but recommended)
```
sudo apt-get install libsundials-dev petsc-dev slepc-dev
```

Clone Github repository

git clone https://github.com/seamplex/feenox

Bootstrap, configure, compile & make
```
cd feenox
./autogen.sh
./configure
make -j4
```
If you cannot (or do not want to) use libgsl-dev from a package repository, call configure with --enable-download-gsl:
```
./configure --enable-download-gsl
```
If you do not have Internet access, get the tarball manually, copy it to the same directory as configure and run again. See the detailed compilation instructions for an explanation.
Run test suite (optional)
```
make check
```
Install the binary system wide (optional)
```
sudo make install
```
If you do not have root permissions, configure with your home directory as prefix and then make install as a regular user:
```
./configure --prefix=$HOME
make
make install
```

To stay up to date, pull and then autogen, configure and make (and optionally install):

git pull
./autogen.sh
./configure
make -j4
sudo make install

See the Compilation Guide for details. Ask in the GitHub Discussions page for help.

3 Licensing

FeenoX is distributed under the terms of the GNU General Public License version 3 or (at your option) any later version. The following text was borrowed from the Gmsh documentation. Replacing “Gmsh” with “FeenoX” gives:

FeenoX is “free software”; this means that everyone is free to use it and to redistribute it on a free basis. FeenoX is not in the public domain; it is copyrighted and there are restrictions on its distribution, but these restrictions are designed to permit everything that a good cooperating citizen would want to do. What is not allowed is to try to prevent others from further sharing any version of FeenoX that they might get from you.

Specifically, we want to make sure that you have the right to give away copies of FeenoX, that you receive source code or else can get it if you want it, that you can change FeenoX or use pieces of FeenoX in new free programs, and that you know you can do these things.

To make sure that everyone has such rights, we have to forbid you to deprive anyone else of these rights. For example, if you distribute copies of FeenoX, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must tell them their rights.

Also, for our own protection, we must make certain that everyone finds out that there is no warranty for FeenoX. If FeenoX is modified by someone else and passed on, we want their recipients to know that what they have is not what we distributed, so that any problems introduced by others will not reflect on our reputation.

The precise conditions of the license for FeenoX are found in the General Public License that accompanies the source code. Further information about this license is available from the GNU Project webpage http://www.gnu.org/copyleft/gpl-faq.html.

FeenoX is licensed under the terms of the GNU General Public License version 3 or, at the user convenience, any later version. This means that users get the four essential freedoms:¹

The freedom to run the program as they wish, for any purpose.
The freedom to study how the program works, and change it so it does their computing as they wish.
The freedom to redistribute copies so they can help others.
The freedom to distribute copies of their modified versions to others.

So a free program has to be open source, but it also has to explicitly provide the four freedoms above both through the written license and through appropriate mechanisms to get, modify, compile, run and document these modifications using well-established and/or reasonable straightforward procedures. That is why licensing FeenoX as GPLv3+ also implies that the source code and all the scripts and makefiles needed to compile and run it are available for anyone that requires it (i.e. it is compiled with ./configure && make). Anyone wanting to modify the program either to fix bugs, improve it or add new features is free to do so. And if they do not know how to program, the have the freedom to hire a programmer to do it without needing to ask permission to the original authors. Even more, the documentation is released under the terms of the Creative Commons Attribution-ShareAlike 4.0 International License so these new (or modified) features can be properly documented as well.

Nevertheless, since these original authors are the copyright holders, they still can use it to either enforce or prevent further actions from the users that receive FeenoX under the GPLv3+. In particular, the license allows re-distribution of modified versions only if

they are clearly marked as different from the original, and
they are distributed under the same terms of the GPLv3+.

There are also some other subtle technicalities that need not be discussed here such as

what constitutes a modified version (which cannot be redistributed under a different license)
what is an aggregate (in which each part be distributed under different licenses)
usage over a network and the possibility of using AGPL instead of GPL to further enforce freedom

These issues are already taken into account in the FeenoX licensing scheme.

It should be noted that not only is FeenoX free and open source, but also all of the libraries it depends on (and their dependencies) also are. It can also be compiled using free and open source build tool chains running over free and open source operating systems.

There are some examples of pieces of computational software which are described as “open source” in which even the first of the four freedoms is denied. The most iconic case is that of Android, whose sources are readily available online but there is no straightforward way of updating one’s mobile phone firmware with a customized version, not to mention vendor and hardware lock ins and the possibility of bricking devices if something unexpected happens. In the nuclear industry, it is the case of a Monte Carlo particle-transport program that requests users to sign an agreement about the objective of its usage before allowing its execution. The software itself might be open source because the source code is provided after signing the agreement, but it is not free (as in freedom) at all.↩︎

Download & install FeenoX

Table of contents