.TH "basis" 1rheolef "Version 7.2" "rheolef" \" -*- nroff -*-
.ad l
.nh
.SH NAME
basis \- plot a finite element basis (rheolef-7\&.2)
.PP
  
.SH "SYNOPSIS"
.PP
.PP
.nf
basis name [element] [options]
.fi
.PP
 
.SH "DESCRIPTION"
.PP
View a finite element polynomial basis on a given reference element (see \fBreference_element(6)\fP)\&. Alternatively, it could show the interpolation nodes\&.
.SH "EXAMPLES"
.PP
.PP
.nf
  basis P5 t
  basis P5[warburton] t
  basis P5[warburton,monomial] t
  basis 'trace(P3d)' t

  basis P3 t -node
  basis P5 t -node-side 0
  basis P5 t -node-side 1
  basis P3 T -node
  basis B7 t
  basis S7 t
  basis RT0 t
  basis RT3 t -node
  basis 'trace_n(RT5d)' t -node
  basis P3d T -node-side 1
  basis 'trace_n(RT5d)' T -node-side 1
.fi
.PP
 
.SH "BASIS AND ELEMENT SPECIFICATIONS"
.PP
The basis \fIname\fP argument is specified as for the \fCspace\fP and \fCbasis\fP constructor class argument (see \fBspace(2)\fP and \fBbasis(2)\fP)\&. The \fIelement\fP argument is one of \fCe\fP, \fCt\fP, \fCq\fP, \fCT\fP, \fCP\fP, \fCH\fP (see \fBreference_element(6)\fP)\&. The \fCgnuplot\fP render is used for visualization\&.
.SH "THE RAW BASIS"
.PP
\fC-raw\fP 
.br
\fC-fem\fP 
.PP
.RS 4
 A raw basis is used for computing the Vandermonde matrix and building the Lagrange basis\&. The raw basis is either \fCmonomial\fP, \fCDubiner\fP or \fCBernstein\fP while \fCDubiner\fP is the default\&. This raw basis is hiden by default: it is represented by using the \fC-raw\fP option while \fC-fem\fP switch back to the default finite element basis representation\&. When the basis family is either \fCM\fP, for \fCmonomial\fP or \fCD\fP for \fCDubiner\fP, there is no ambiguity, and the \fC-raw\fP option could be omitted\&. Conversely, when the basis family is \fCB\fP, for \fCBernstein\fP, then, there is an ambiguity and this option should be used\&. 
.RE
.PP
Here is an example of raw basis visualization: 
.PP
.nf
basis M4 t
basis D5 e
basis B5 e -raw

.fi
.PP
 Here, the \fC-raw\fP option is used to disambiguate 
.br
 between the Bernstein basis as finite element basis and the Bernstein basis as a raw basis\&.
.SH "REDERING OPTIONS"
.PP
The \fCbasis\fP command supports several modes of visualization:
.PP
\fC-ndof\fP 
.PP
.RS 4
 Print the basis size, i\&.e\&. the number of degrees of freedom (ndof)\&. 
.RE
.PP
\fC-poly\fP 
.PP
.RS 4
 Represents the polynomial functions in elevation, for 1D and 2D elements (3D elements visualization not yet supported)\&. All basis polynomials are showed in an animation\&. 
.RE
.PP
\fC-node\fP 
.PP
.RS 4
 Represents the node location, with distinct colors for each dimension associated to\&. 
.RE
.PP
\fC-node-side\fP 
.PP
.RS 4
 Represents the node location, restricted on a specific side\&. 
.RE
.PP
.SH "OTHERS OPTIONS"
.PP
\fC-[no]verbose\fP 
.PP
.RS 4
 Print messages related to graphic files created and command system calls (this is the default)\&. 
.RE
.PP
\fC-[no]clean\fP 
.PP
.RS 4
 Clear temporary graphic files (this is the default)\&.
.PP
.RE
.PP
\fC-[no]execute\fP 
.PP
.RS 4
 Execute graphic command (this is the default)\&. The \fC-noexecute\fP variant is useful in conjunction with the \fC-verbose\fP and \fC-noclean\fP options in order to modify some render options by hand\&. 
.RE
.PP
.SH "LIMITATIONS"
.PP
Polynomial visualization in 3D are not yet supported: future development will use paraview with volume mode and animation for scanning all basis polynomials\&.
.SH "IMPLEMENTATION"
.PP
This documentation has been generated from file fem/lib/basis\&.cc 
.SH AUTHOR
Pierre  Saramito  <Pierre.Saramito@imag.fr>
.SH COPYRIGHT
Copyright   (C)  2000-2018  Pierre  Saramito  <Pierre.Saramito@imag.fr>
GPLv3+: GNU GPL version 3 or later  <http://gnu.org/licenses/gpl.html>.
This  is  free  software:  you  are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.