README.md

---

title: FeenoX documentation index titleblock: | FeenoX documentation index

lang: en-US ...

Every bit of FeenoX documentation is written in Pandoc-flavored Markdown in the doc directory of the FeenoX repository. It is then converted to HTML, PDF, Unix manpage or Texinfo as needed. FeenoX documentation is released under the terms of the Creative Commons Attribution-ShareAlike 4.0 International License.

Manual and description

As per the GNU Coding Standards, "a manual should serve both as tutorial and reference." Due to the formatting restrictions, the Texinfo version contains only the description and not the full reference.

• FeenoX manual [PDF]
• FeenoX description [PDF] [Texinfo]

Design

1. The FeenoX project starts as an offer to an imaginary “request for quotations” that defines software requirements specifications for an open source computational tool.

   • Software Requirements Specification (Fictitious RFQ) [PDF]

2. Then a fictitious “offer” to the above tender is given in a software design specifications document that explains the design decisions and features included in FeenoX.

   • Software Design Specification (Imaginary FeenoX's offer) [PDF]

::::::::: {.only-in-format .html .markdown}

Why FeenoX works the way it works (i.e. why it does not run in Windows)

::::: {.container .text-center .my-5 .ratio .ratio-16x9}

<iframe class="embed-responsive-item" src="https://www.youtube.com/embed/66WvYTb4pSg?rel=0" allowfullscreen></iframe> :::::

:::::::::

Other documents

• Unix manpage (accessible with man feenox after (global) installation with sudo make install)
• Frequently Asked Questions PDF
• Compilation Guide PDF
• Programming Guide PDF
• History PDF

Youtube videos {#sec:youtube}

• FeenoX hands-on tutorial
• FeenoX, a cloud-first free and open source finite-element(ish) tool
• Why FeenoX works the way it works
• Verification of PDE solvers using the Method of Manufactured Solutions
• FeenoX: a free and open source computational tool for solving (nuclear-related) DAEs in the cloud
• CAEplex: finite elements in the cloud
• Thermal finite elements in the cloud in 1 minute
• Add CAE to your Onshape CAD with CAEplex
• First 10 natural modes of a cylinder in less than 1 min. with CAEplex
• Democratizing CAE

Markdown sources

The Markdown sources are in the doc:

• feenox-manual
• feenox-desc
• srs
• sds
• FAQ
• feenox.1
• history
• compilation
• programming

They are compiled by running the make.sh script.

Hands on

Go directly to the point and see how to solve problems with FeenoX. Everything needed (input files, geometry files, meshes, data, scripts, etc.) is included in the FeenoX repository.

Examples

Annotated examples can be found in the examples directory of the Github repository.

• Online annotated examples
  • Basic mathematics
  • Systems of ODEs/DAEs
  • Laplace’s equation
  • Heat conduction
  • Elasticity (both small and large strain)
  • Modal analysis
  • Neutron diffusion
  • Neutron S_N
• Github examples directory

Tutorials

tutorials/setup.md

tutorials/general.md

tutorials/detailed.md

tutorials/physics.md

Tests

The tests directory in the repository has hundreds of

• grep-able examples,
• unit tests,
• regression tests, and/or
• (crude) mathematical verification tests.

Contributing

Asking questions & reporting bugs

• Use Github discussions to ask for help,
• Use the Github issue tracker to report bugs.

Contributing guidelines

contributing-guidelines.md

Adding a new PDE to src/pdes

To be explained.