Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
gmsh
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Model registry
Operate
Environments
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
GitLab community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
Larry Price
gmsh
Commits
b0142ca1
Commit
b0142ca1
authored
Apr 19, 2003
by
Christophe Geuzaine
Browse files
Options
Downloads
Patches
Plain Diff
Move affectation definition into 'General commands'
parent
f6a496aa
No related branches found
No related tags found
No related merge requests found
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
doc/texinfo/gmsh.texi
+138
-134
138 additions, 134 deletions
doc/texinfo/gmsh.texi
with
138 additions
and
134 deletions
doc/texinfo/gmsh.texi
+
138
−
134
View file @
b0142ca1
\input
texinfo.tex @c -*-texinfo-*-
\input
texinfo.tex @c -*-texinfo-*-
@c
$
Id: gmsh.texi,v
1
.
3
1
2003
-
04
-
19
04
:
14
:
53
geuzaine Exp
$
@c
$
Id: gmsh.texi,v
1
.
3
2
2003
-
04
-
19
16
:
34
:
44
geuzaine Exp
$
@c
@c
@c Copyright (C) 1997-2003 C. Geuzaine, J.-F. Remacle
@c Copyright (C) 1997-2003 C. Geuzaine, J.-F. Remacle
@c
@c
...
@@ -684,8 +684,8 @@ parsing of the data file:
...
@@ -684,8 +684,8 @@ parsing of the data file:
@example
@example
@var
{
expression
}
:
@var
{
expression
}
:
@var
{
real
}
|
@var
{
real
}
|
@var
{
expression-id
}
|
@var
{
string
}
|
@var
{
expression-id
}
[ @var
{
expression
}
] |
@var
{
string
}
[ @var
{
expression
}
] |
@var
{
operator-unary
}
@var
{
expression
}
|
@var
{
operator-unary
}
@var
{
expression
}
|
@var
{
expression
}
@var
{
operator-binary
}
@var
{
expression
}
|
@var
{
expression
}
@var
{
operator-binary
}
@var
{
expression
}
|
@var
{
expression
}
@var
{
operator-ternary-left
}
@var
{
expression
}
@var
{
operator-ternary-right
}
@var
{
expression
}
|
@var
{
expression
}
@var
{
operator-ternary-left
}
@var
{
expression
}
@var
{
operator-ternary-right
}
@var
{
expression
}
|
...
@@ -697,7 +697,9 @@ Such @w{@var{expression}s} are used in most of Gmsh's commands. The
...
@@ -697,7 +697,9 @@ Such @w{@var{expression}s} are used in most of Gmsh's commands. The
operators @var
{
operator-unary
}
, @var
{
operator-binary
}
and
operators @var
{
operator-unary
}
, @var
{
operator-binary
}
and
@var
{
operator-ternary-left
}
/@var
{
operator-ternary-right
}
are defined in
@var
{
operator-ternary-left
}
/@var
{
operator-ternary-right
}
are defined in
@ref
{
Operators
}
. For the definition of @w
{
@var
{
built-in-function
}
s
}
, see
@ref
{
Operators
}
. For the definition of @w
{
@var
{
built-in-function
}
s
}
, see
@ref
{
Built-in functions
}
.
@ref
{
Built-in functions
}
. The various @w
{
@var
{
real-option
}
s
}
are listed in
@ref
{
General options
}
, @ref
{
Geometry options
}
, @ref
{
Mesh options
}
,
@ref
{
Solver options
}
, and @ref
{
Post-processing options
}
.
@cindex Expressions, lists
@cindex Expressions, lists
...
@@ -715,8 +717,8 @@ List of expressions are also widely used, and are defined as:
...
@@ -715,8 +717,8 @@ List of expressions are also widely used, and are defined as:
@var
{
expression
}
|
@var
{
expression
}
|
@var
{
expression
}
: @var
{
expression
}
|
@var
{
expression
}
: @var
{
expression
}
|
@var
{
expression
}
: @var
{
expression
}
: @var
{
expression
}
|
@var
{
expression
}
: @var
{
expression
}
: @var
{
expression
}
|
@var
{
expression-id
}
[ ] |
@var
{
string
}
[ ] |
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
]
@var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
]
@end example
@end example
The second case in this last definition permits to create a list containing
The second case in this last definition permits to create a list containing
...
@@ -734,98 +736,6 @@ In order to lighten the syntax, you can always ommit the braces @code{@{@}}
...
@@ -734,98 +736,6 @@ In order to lighten the syntax, you can always ommit the braces @code{@{@}}
enclosing an @var
{
expression-list
}
if this @var
{
expression-list
}
contains a
enclosing an @var
{
expression-list
}
if this @var
{
expression-list
}
contains a
single item.
single item.
@cindex Expressions, affectation
@cindex Expressions, identifiers
@findex =
@findex +=
@findex -=
@findex *=
@findex /=
The syntax for the definition of a new expression identifier is twofold,
depending on the nature of the right hand side (being a single
@var
{
expression
}
or a list):
@example
@var
{
expression-id
}
= @var
{
expression
}
;
@var
{
expression-id
}
[ ] = @
{
@var
{
expression-list
}
@
}
;
@end example
@noindent with
@example
@var
{
expression-id
}
:
@var
{
string
}
|
@var
{
real-option
}
@end example
The various @w
{
@var
{
real-option
}
s
}
are listed in @ref
{
General options
}
,
@ref
{
Geometry options
}
, @ref
{
Mesh options
}
, @ref
{
Solver options
}
, and
@ref
{
Post-processing options
}
. In addition to the @w
{
@var
{
real-option
}
s
}
,
eight @w
{
@var
{
expression-id
}
s
}
are predefined (hard coded in Gmsh's parser):
@ftable @code
@item Pi
Returns 3.1415926535897932.
@item MPI
_
Size
Returns the number of processors on which Gmsh is running (always 1, except
if you compiled Gmsh's parallel extensions).
@item MPI
_
Rank
Returns the rank of the current processor.
@item newp
Returns the next available point number. As we will see in @ref
{
Geometry
module
}
, a unique number is associated with every geometrical point:
@code
{
newp
}
permits to know the highest number already attributed. This is
mostly useful when writing user-defined functions (@pxref
{
User-defined
functions
}
) or general geometric primitives, when one does not know a priori
which numbers are already attributed, and which ones are still available.
@item newl
Returns the next available line number.
@item news
Returns the next available surface number.
@item newv
Returns the next available volume number.
@item newreg
Returns the next available region number. That is, @code
{
newreg
}
returns the
maximum of @code
{
newp
}
, @code
{
newc
}
, @code
{
news
}
, @code
{
newv
}
and all
physical entity numbers@footnote
{
For compatibility purposes, the behavior
of @code
{
newc
}
, @code
{
news
}
, @code
{
newv
}
and @code
{
newreg
}
can be modified
with the @code
{
Geometry.OldNewReg
}
option (@pxref
{
Geometry options
}
).
}
.
@end ftable
One can also perform additions, subtractions, multiplications and divisions
while affecting a value to an existing @var
{
expression-id
}
, using:
@example
@var
{
expression-id
}
+= @var
{
expression
}
;
@var
{
expression-id
}
-= @var
{
expression
}
;
@var
{
expression-id
}
*= @var
{
expression
}
;
@var
{
expression-id
}
/= @var
{
expression
}
;
@end example
@noindent for single expressions, and
@example
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
] = @
{
@var
{
expression-list
}
@
}
;
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
] += @
{
@var
{
expression-list
}
@
}
;
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
] -= @
{
@var
{
expression-list
}
@
}
;
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
] *= @
{
@var
{
expression-list
}
@
}
;
@var
{
expression-id
}
[ @
{
@var
{
expression-list
}
@
}
] /= @
{
@var
{
expression-list
}
@
}
;
@end example
@noindent for lists of expressions@footnote
{
Remember the remark made when
defining @w
{
@var
{
expression-list
}
s
}
: the braces enclosing the
@var
{
expression-list
}
are optional if the @var
{
expression-list
}
only
contains a single item.
}
, in which case the affectations are done ``list
item per list item''.
@c .........................................................................
@c .........................................................................
@c Character expressions
@c Character expressions
@c .........................................................................
@c .........................................................................
...
@@ -844,7 +754,7 @@ Character expressions are defined as:
...
@@ -844,7 +754,7 @@ Character expressions are defined as:
StrPrefix ( @var
{
char-expression
}
) |
StrPrefix ( @var
{
char-expression
}
) |
StrCat ( @var
{
char-expression
}
, @var
{
char-expression
}
) |
StrCat ( @var
{
char-expression
}
, @var
{
char-expression
}
) |
Sprintf ( @var
{
char-expression
}
, @var
{
expression-list
}
) |
Sprintf ( @var
{
char-expression
}
, @var
{
expression-list
}
) |
@var
{
string
-option
}
@var
{
char
-option
}
@end example
@end example
@noindent The second case in this definition permits to take the
@noindent The second case in this definition permits to take the
...
@@ -852,21 +762,15 @@ prefix of a string (e.g. for removing the extension from a file name). The
...
@@ -852,21 +762,15 @@ prefix of a string (e.g. for removing the extension from a file name). The
third case permits to concatenate two character expressions, and the fourth
third case permits to concatenate two character expressions, and the fourth
is an equivalent of the @code
{
sprintf
}
C function (where
is an equivalent of the @code
{
sprintf
}
C function (where
@var
{
char-expression
}
is a format string that can contain floating point
@var
{
char-expression
}
is a format string that can contain floating point
formatting characters: @code
{
%e}, @code{%g}, etc.).
formatting characters: @code
{
%e}, @code{%g}, etc.). The last case permits to
use the value of a @var
{
char-option
}
as a @var
{
char-expression
}
. The
various @w
{
@var
{
char-option
}
s
}
are listed in @ref
{
General options
}
,
@ref
{
Geometry options
}
, @ref
{
Mesh options
}
, @ref
{
Solver options
}
, and
@ref
{
Post-processing options
}
.
Character expressions are mostly used to specify non-numeric options and
Character expressions are mostly used to specify non-numeric options and
input/output file names. See @ref
{
t8.geo
}
, for an interesting usage of
input/output file names. See @ref
{
t8.geo
}
, for an interesting usage of
@w
{
@var
{
char-expression
}
s
}
in an animation script. Although there exists no
@w
{
@var
{
char-expression
}
s
}
in an animation script.
character expression identifier, @w
{
@var
{
char-expression
}
s
}
can be affected
to @w
{
@var
{
string-option
}
s
}
:
@example
@var
{
string-option
}
= @var
{
char-expression
}
;
@end example
The various @w
{
@var
{
string-option
}
s
}
are listed in @ref
{
General options
}
,
@ref
{
Geometry options
}
, @ref
{
Mesh options
}
, @ref
{
Solver options
}
, and
@ref
{
Post-processing options
}
.
@c .........................................................................
@c .........................................................................
@c Color expressions
@c Color expressions
...
@@ -895,19 +799,13 @@ e.g., @code{Red}, @code{SpringGreen}, @code{LavenderBlush3},@w{ }@dots{}
...
@@ -895,19 +799,13 @@ e.g., @code{Red}, @code{SpringGreen}, @code{LavenderBlush3},@w{ }@dots{}
to define colors by using three expressions to specify their red, green and
to define colors by using three expressions to specify their red, green and
blue components (with values comprised between 0 and 255). The third case
blue components (with values comprised between 0 and 255). The third case
permits to define colors by using the red, green and blue color components
permits to define colors by using the red, green and blue color components
as well as the alpha channel. See @ref
{
t3.geo
}
, for an example of the use of
as well as the alpha channel. The last case permits to use the value of a
color expressions.
@var
{
color-option
}
as a @var
{
color-expression
}
. The various
@w
{
@var
{
color-option
}
s
}
are listed in @ref
{
General options
}
, @ref
{
Geometry
Although there exists no color expression identifier,
options
}
, @ref
{
Mesh options
}
, @ref
{
Solver options
}
, and @ref
{
Post-processing
@w
{
@var
{
color-expression
}
s
}
can be affected to @w
{
@var
{
color-option
}
s
}
:
options
}
.
@example
@var
{
color-option
}
= @var
{
color-expression
}
;
@end example
The various @w
{
@var
{
color-option
}
s
}
are listed in @ref
{
General options
}
,
See @ref
{
t3.geo
}
, for an example of the use of color expressions.
@ref
{
Geometry options
}
, @ref
{
Mesh options
}
, @ref
{
Solver options
}
, and
@ref
{
Post-processing options
}
.
@c -------------------------------------------------------------------------
@c -------------------------------------------------------------------------
@c Operators
@c Operators
...
@@ -994,9 +892,10 @@ argument.
...
@@ -994,9 +892,10 @@ argument.
@findex ()
@findex ()
The evaluation priorities are summarized below (from stronger to weaker,
The evaluation priorities are summarized below@footnote
{
The affectation
i.e.@: @code
{
*
}
has a highest evaluation priority than
operators are introduced in @ref
{
General commands
}
.
}
(from stronger to
@code
{
+
}
). Parentheses @code
{
()
}
may be used anywhere to change the order of
weaker, i.e.@: @code
{
*
}
has a highest evaluation priority than @code
{
+
}
).
Parentheses @code
{
()
}
may be used anywhere to change the order of
evaluation:
evaluation:
@enumerate
@enumerate
...
@@ -1198,10 +1097,115 @@ writing (Gmsh 1.44).
...
@@ -1198,10 +1097,115 @@ writing (Gmsh 1.44).
@cindex General commands
@cindex General commands
@cindex Commands, general
@cindex Commands, general
@cindex Expressions, affectation
@cindex Expressions, identifiers
@findex =
@findex +=
@findex -=
@findex *=
@findex /=
The following commands can be used anywhere in a Gmsh ASCII text input file:
The following commands can be used anywhere in a Gmsh ASCII text input file:
@ftable @code
@ftable @code
@item @var
{
string
}
= @var
{
expression
}
;
Defines a new expression identifier @var
{
string
}
, or affects
@var
{
expression
}
to an existing expression identifier. Note that eight
expression identifiers are predefined (hard coded in Gmsh's parser):
@ftable @code
@item Pi
Returns 3.1415926535897932.
@item MPI
_
Size
Returns the number of processors on which Gmsh is running (always 1, except
if you compiled Gmsh's parallel extensions).
@item MPI
_
Rank
Returns the rank of the current processor.
@item newp
Returns the next available point number. As we will see in @ref
{
Geometry
module
}
, a unique number is associated with every geometrical point:
@code
{
newp
}
permits to know the highest number already attributed. This is
mostly useful when writing user-defined functions (@pxref
{
User-defined
functions
}
) or general geometric primitives, when one does not know a priori
which numbers are already attributed, and which ones are still available.
@item newl
Returns the next available line number.
@item news
Returns the next available surface number.
@item newv
Returns the next available volume number.
@item newreg
Returns the next available region number. That is, @code
{
newreg
}
returns the
maximum of @code
{
newp
}
, @code
{
newc
}
, @code
{
news
}
, @code
{
newv
}
and all
physical entity numbers@footnote
{
For compatibility purposes, the behavior
of @code
{
newc
}
, @code
{
news
}
, @code
{
newv
}
and @code
{
newreg
}
can be modified
with the @code
{
Geometry.OldNewReg
}
option (@pxref
{
Geometry options
}
).
}
.
@end ftable
@item @var
{
string
}
[ ] = @
{
@var
{
expression-list
}
@
}
;
Defines a new expression list identifier @code
{
@var
{
string
}
[]
}
, or affects
@var
{
expression-list
}
to an existing expression list identifier.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] = @
{
@var
{
expression-list
}
@
}
;
Affects, item per item, @var
{
expression-list
}
to an existing expression list
identifier. Remember the remark made when defining
@w
{
@var
{
expression-list
}
s
}
: the braces enclosing the
@w
{
@var
{
expression-list
}
s
}
are optional if the @var
{
expression-list
}
only
contains a single item.
@item @var
{
real-option
}
= @var
{
expression
}
;
Affects @var
{
expression
}
to a real option.
@item @var
{
char-option
}
= @var
{
char-expression
}
;
Affects @var
{
char-expression
}
to a character option.
@item @var
{
color-option
}
= @var
{
color-expression
}
;
Affects @var
{
color-expression
}
to a color option.
@item @var
{
string
}
| @var
{
real-option
}
+= @var
{
expression
}
;
Adds and affects @var
{
expression
}
to an existing expression identifier or to
a real option.
@item @var
{
string
}
| @var
{
real-option
}
-= @var
{
expression
}
;
Subtracts and affects @var
{
expression
}
to an existing expression identifier
or to a real option.
@item @var
{
string
}
| @var
{
real-option
}
*-= @var
{
expression
}
;
Multiplies and affects @var
{
expression
}
to an existing expression identifier
or to a real option.
@item @var
{
string
}
| @var
{
real-option
}
/= @var
{
expression
}
;
Divides and affects @var
{
expression
}
to an existing expression identifier
or to a real option.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] = @
{
@var
{
expression-list
}
@
}
;
Affects, item per item, @var
{
expression-list
}
to an existing expression list
identifier.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] += @
{
@var
{
expression-list
}
@
}
;
Adds and affects, item per item, @var
{
expression-list
}
to an existing
expression list identifier.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] -= @
{
@var
{
expression-list
}
@
}
;
Subtracts and affects, item per item, @var
{
expression-list
}
to an existing
expression list identifier.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] *= @
{
@var
{
expression-list
}
@
}
;
Multiplies and affects, item per item, @var
{
expression-list
}
to an existing
expression list identifier.
@item @var
{
string
}
[ @
{
@var
{
expression-list
}
@
}
] /= @
{
@var
{
expression-list
}
@
}
;
Divides and affects, item per item, @var
{
expression-list
}
to an existing
expression list identifier.
@item Exit;
@item Exit;
Aborts the current script.
Aborts the current script.
...
@@ -1250,14 +1254,14 @@ input file. Both include commands should be given on a line of their own.
...
@@ -1250,14 +1254,14 @@ input file. Both include commands should be given on a line of their own.
@node General options, , General commands, General tools
@node General options, , General commands, General tools
@section General options
@section General options
Here is the list of the general @w
{
@var
{
string
-option
}
s
}
,
Here is the list of the general @w
{
@var
{
char
-option
}
s
}
,
@w
{
@var
{
real-option
}
s
}
and @w
{
@var
{
color-option
}
s
}
(in that order---check
@w
{
@var
{
real-option
}
s
}
and @w
{
@var
{
color-option
}
s
}
(in that order---check
the default values to see the types). Most of these options are
accessible
the default values to see the
actual
types). Most of these options are
in the graphical user interface, but not all of them. When
running Gmsh
accessible
in the graphical user interface, but not all of them. When
interactively, changing an option in the ASCII text input file
will modify
running Gmsh
interactively, changing an option in the ASCII text input file
the option in the GUI in real time. This permits for example to
resize the
will modify
the option in the GUI in real time. This permits for example to
graphical window in a script, or to interact with animations in
the script
resize the
graphical window in a script, or to interact with animations in
and in the GUI at the same time.
the script
and in the GUI at the same time.
Gmsh's default behavior is to save some of these options in a per-user
Gmsh's default behavior is to save some of these options in a per-user
``session resource'' file (@code
{
General.SessionFileName
}
) each time Gmsh is
``session resource'' file (@code
{
General.SessionFileName
}
) each time Gmsh is
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment
