getdp.texi

cfd求解器使用与gmsh网格的求解

\input texinfo.tex @c -*-texinfo-*-
@c $Id: getdp.texi,v 1.89 2006/02/28 18:49:55 geuzaine Exp $
@c
@c Copyright (C) 1997-2006 P. Dular, C. Geuzaine
@c
@c This program is free software; you can redistribute it and/or modify
@c it under the terms of the GNU General Public License as published by
@c the Free Software Foundation; either version 2 of the License, or
@c (at your option) any later version.
@c
@c This program is distributed in the hope that it will be useful,
@c but WITHOUT ANY WARRANTY; without even the implied warranty of
@c MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
@c GNU General Public License for more details.
@c
@c You should have received a copy of the GNU General Public License
@c along with this program; if not, write to the Free Software
@c Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
@c USA.
@c 
@c Please report all bugs and problems to <[e-mail]>.
@c
@c =========================================================================
@c
@c This is the GetDP documentation texinfo source file
@c
@c Things to do -> "Ctrl+s todo:" 
@c
@c Indexing: @cindex = concept index, e.g. "Numerical tools, overview"
@c           @vindex = (metasyntactic) variable index, e.g.  "constraint-type"
@c          /@tindex = type index (=frozen syntax ossature), e.g. "DefineGroup"
@c          \@findex = function index (=all types in the objects), e.g. "Curl"
@c
@c Before release, run C-u C-c C-u C-a in GNU Emacs
@c This updates all node pointers and menus
@c 
@c =========================================================================
@c %**start of header
@setfilename        getdp.info
@set GETDP-VERSION  1.2
@set GETDP-WEB      @uref{http://www.geuz.org/getdp/}
@set GETDP-WIKI     @uref{http://www.geuz.org/getdp/wiki/FrontPage}
@set GMSH-WEB       @uref{http://www.geuz.org/gmsh/}
@set COPYRIGHT      @copyright{} 1997-2006 Patrick Dular, Christophe Geuzaine
@c
@settitle GetDP @value{GETDP-VERSION}
@footnotestyle separate
@setchapternewpage odd
@paragraphindent 0
@finalout
@c %**end of header

@c merge function index into type index
@syncodeindex fn tp

@c =========================================================================
@c Info directives
@c =========================================================================

@ifinfo
@dircategory Math
@direntry
* GetDP: (getdp).  General finite element solver
@end direntry
@noindent
This is the @cite{GetDP Reference Manual} for GetDP
@value{GETDP-VERSION} (@today{}).
@noindent
Copyright @value{COPYRIGHT}.
@end ifinfo

@c =========================================================================
@c TeX directives
@c =========================================================================

@iftex
@global@let@sl=@it
@global@setfont@indit@itshape{9}{1000}
@end iftex

@c =========================================================================
@c Title page
@c =========================================================================

@shorttitlepage GetDP

@titlepage

@title GetDP Reference Manual

@subtitle The documentation for GetDP @value{GETDP-VERSION}
@subtitle A General environment for the treatment of Discrete Problems
@subtitle 
@subtitle @today{}

@author Patrick Dular
@author Christophe Geuzaine

@page
@vskip 0pt plus 1filll
Copyright @value{COPYRIGHT}
@sp 1
University of Li@`ege @*
Department of Electrical Engineering @*
Institut d'@'Electricit@'e Montefiore @*
Sart Tilman Campus, Building B28 @*
B-4000 Li@`ege @*
BELGIUM
@sp 1
Permission is granted to make and distribute verbatim copies of this manual
provided the copyright notice and this permission notice are preserved on
all copies.

@end titlepage

@c =========================================================================
@c Table of contents
@c =========================================================================

@summarycontents
@contents

@c =========================================================================
@c Top node (for all output, except TeX)
@c =========================================================================

@ifnottex
@node Top, Copying conditions, (dir), (dir)
@top GetDP

Patrick Dular and Christophe Geuzaine

GetDP is a scientific computation software for the numerical solution of
integro-differential equations, using finite element and integral type
methods. This is the @cite{GetDP Reference Manual} for GetDP
@value{GETDP-VERSION} (@today{}).
@end ifnottex

@c =========================================================================
@c Master menu
@c =========================================================================

@menu
* Copying conditions::          Terms and conditions of use.
* Introduction::                What is GetDP?
* Overview::                    Quick overview of the general philosophy of GetDP.
* Expressions::                 Definition of basic expressions in GetDP.
* Objects::                     Definition of the 10 GetDP objects.
* Types for objects::           Definition of all available types for the 10 objects.
* Short examples::              Simple object examples.
* Complete examples::           Some simple complete examples.
* Running GetDP::               How to run GetDP on your operating system.
* File formats::                Input and output file formats.
* Bugs and versions::           Contact information and ChangeLog
* Tips and tricks::             Some tips to make your life easier with GetDP.
* Frequently asked questions::  The GetDP FAQ
* Gmsh examples::               Sample Gmsh input files.
* License::                     Complete copy of the license.
* Concept index::               Index of concepts.
* Metasyntactic variable index::  Index of metasyntactic variables used in this manual.
* Syntax index::                Index of reserved keywords in the GetDP language.

@detailmenu
 --- The Detailed Node Listing ---

Introduction

* Research::                    
* Education::                   
* Industry::                    
* How to Read this Manual::     

Overview

* Numerical tools as objects::  
* Syntactic rules::             
* Comments::                    
* Includes::                    
* Which problems can GetDP actually solve?::  

Expressions 

* Expression definition::
* Constants::                   
* Operators::                   
* Functions::                   
* Current values::              
* Arguments::                   
* Registers::                   
* Fields::                      
* Loops and conditionals::      

Definition

* Operators::                   
* Constants::                   
* Functions::                   
* Current values::              
* Fields::                      

Operators

* Operator types::              
* Evaluation order::            

Objects

* Group::                       
* Function::                    
* Constraint::                  
* FunctionSpace::               
* Jacobian::                    
* Integration::                 
* Formulation::                 
* Resolution::                  
* PostProcessing::              
* PostOperation::               

Types for objects

* Types for Group::             
* Types for Function::          
* Types for Constraint::        
* Types for FunctionSpace::     
* Types for Jacobian::          
* Types for Integration::       
* Types for Formulation::       
* Types for Resolution::        
* Types for PostProcessing::    
* Types for PostOperation::     

Types for @code{Function}

* Math functions::              
* Extended math functions::     
* Green functions::             
* Type manipulation functions::  
* Coordinate functions::        
* Miscellaneous functions::     

Short examples

* Constant expression examples::  
* Group examples::              
* Function examples::           
* Constraint examples::         
* FunctionSpace examples::      
* Jacobian examples::           
* Integration examples::        
* Formulation examples::        
* Resolution examples::         
* PostProcessing examples::     
* PostOperation examples::      

@code{FunctionSpace} examples

* Conform space::               
* High order space::            
* Global values::               
* Curl-conform space::          
* Gauge condition::             
* Coupled spaces::              
* Multiply connected domains::  

@code{Formulation} examples

* Electrostatics::              
* Electrostatics 2::            
* Magnetostatics::              
* Magnetodynamics::             
* Other formulations::          

@code{Resolution} examples

* Static resolution::           
* Frequency domain resolution::  
* Time domain resolution::      
* Nonlinear resolution::        
* Coupled formulations::        

Complete examples

* Electrostatic problem::       
* Magnetostatic problem::       
* Magnetodynamic problem::      

File formats

* Input file format::           
* Output file format::          

Output file format

* File pre::                    
* File res::                    

Bugs, versions and credits

* Bugs::                        
* Versions::                    
* Credits::                     

@end detailmenu
@end menu

@c =========================================================================
@c Copying Conditions
@c =========================================================================

@node Copying conditions, Introduction, Top, Top
@unnumbered Copying conditions

@cindex Copyright
@cindex License

@include copying.texi

@c =========================================================================
@c Introduction
@c =========================================================================

@node Introduction, Overview, Copying conditions, Top
@unnumbered Introduction

@cindex Introduction

GetDP (a ``General environment for the treatment of Discrete Problems'') is
a scientific software environment for the numerical solution of
integro-differential equations, open to the coupling of physical problems
(electromagnetic, thermal, etc.) as well as of numerical methods (finite
element method, integral methods, etc.). It can deal with such problems of
various dimensions (1D, 2D or 3D) and time states (static, transient or
harmonic).

The main feature of GetDP is the closeness between its internal
structure (written in C), the organization of data defining discrete
problems (written by the user in ASCII data files) and the symbolic
mathematical expressions of these problems. Its aim is to be welcoming
and of easy use for both development and application levels: it consists
of a working environment in which the definition of any problem
makes use of a limited number of objects, which makes the environment
structured and concise. It therefore gives researchers advanced
developing tools and a large freedom in adding new functionalities.

The modeling tools provided by GetDP can be tackled at various levels of
complexity: this opens the software to a wide range of activities, such
as research, collaboration, education, training and industrial studies.

@menu
* Research::                    
* Education::                   
* Industry::                    
* How to Read this Manual::     
@end menu

@c -------------------------------------------------------------------------
@c Research and Collaboration Activities
@c -------------------------------------------------------------------------

@node Research, Education, Introduction, Introduction
@heading Research and collaboration activities

The internal structure of the software is very close to the structure
used to define discrete problems in the input data files. As a result, a
unicity and conciseness of both development and application levels is
obtained without any interface between them, which facilitates work of
any kind---particularly validations.  GetDP permits to rapidly develop
tools for the comparison of methods and the exchange of solutions
between research teams, which is one of the main aims of collaboration.
Moreover, after a short training, GetDP could be used by teams as a basis
for their own developments, while allowing a large freedom in the latter.

@c -------------------------------------------------------------------------
@c Education and Training Activities
@c -------------------------------------------------------------------------

@node Education, Industry, Research, Introduction
@heading Education and training activities

The software environment consists of modeling tools applicable to various
physical problems. Education and training can therefore be offered in
various domains and at different levels.  The closeness between the
definition of discrete problems and their symbolic mathematical expressions
entails that the theory and mathematical bases of numerical methods, which
are essential to anyone who wants to tackle the solving of discrete
problems, can be directly followed by their practical applications. These
applications can be evolutionary, in the sense that the offered tools are
of various levels of complexity. Everyone can tackle, step by step,
according to his apprenticeship level, the tools adapted to the solving of