• The added line is THIS COLOR.
• The deleted line is THIS COLOR.
#author("2019-10-25T23:45:30+09:00","default:LMNtal","LMNtal")
//[[Documentation]]

*Syntax
**Processes
#mathjax

An LMNtal program is written as an LMNtal process, and
an LMNtal process is a multiset (bag) of the following:
*Syntax [#e9c2d5d7]
**Processes [#q226387a]

An LMNtal program is written as an LMNtal process that represents hierarchical graphs (consisting of atoms, links and membranes) with rewrite rules for them.
An LMNtal process is a multiset (bag) of the following:

|BGCOLOR(white):syntactic&br;category|BGCOLOR(white):form|BGCOLOR(white):description|
|BGCOLOR(white):''atoms'' | '''p'''('''X'''&size(10){1};, ..., '''X'''&size(10){'''n'''};) | a graph node with a symbolic ''name'' '''p''' and an ordered sequence of ''links'' '''X'''&size(10){'''i'''}; |
|BGCOLOR(white):''cells'' | { '''Process''' }&br;'''m'''{ '''Process''' } | a process enclosed with a ''membrane'' (curly braces),&br;optionally with a membrane name '''m''' |
|BGCOLOR(white):''rules'' | ( '''Head''' :- '''Body''' )  | a rewrite rule for processes, explained below |
|BGCOLOR(white):''atoms'' | $$p(X_1,\dots,X_n)$$ | a graph node with a symbolic ''name'' $$p$$ and an ordered sequence of ''links'' $$X_i$$ |
|BGCOLOR(white):''cells'' | $$\{ \textit{Process}\,\}$$&br; $$m\{ \textit{Process}\,\}$$ | a process enclosed with a ''membrane'' (curly braces),&br;optionally with a membrane name $$m$$ |
|BGCOLOR(white):''rules'' | $$(\textit{Head}\ \texttt{:-}\ \textit{Body}\,)$$  | a rewrite rule for processes, explained below |

The elements of a multiset are either separated by commas (e.g., a(X), b(X)) or terminated by periods (e.g., a(X). b(X).) .
The elements of a multiset are either separated by commas (e.g., a(X), b(X)) or terminated by periods (e.g., a(X). b(X).).

Links names are written using alphanumeric tokens starting with capital letters
(e.g., X, Res).
The other alpha-numeric tokens are treated as atom or membrane names
(e.g., foo, 123).
Quoted symbols can also be used for atom or membrane names
(e.g., "foo", 'bar', [:baz:]).

Since link names stand for endpoints of one-to-one links, each link name in a well-formed process must occur at most twice, and each link name in a well-formed rule must occur exactly twice.
Since link names stand for endpoints of one-to-one links, '''each link name in a well-formed process must occur at most twice, and each link name in a well-formed rule must occur exactly twice.'''  A link occurring only once in a process is called a ''free link''.  A process with no free link is called a ''closed process''.

***Term Abbreviation Scheme
For instance, the first example below is a well-formed process with one free link Y, and the second and the third examples are well-formed closed processes.

plus(AX,B,Y), times(A,X,AX), a(A), b(B), x(X).
p(X,Y), p(Y,Z), p(Z,X), p(U,U).
out(X), { in(X), out(Y), { in(Y), a, b }}.

LMNtal comes with a special atom '=', called a ''connector'', as will be described later.

***Term Notation [#je3d0553]

Atoms with '''n''' links are often used to represent ('''n'''-1)-ary terms, where the '''n'''th link of the atom represents the "entry point" of the term.
Since each link name occurs at most twice, we can abbreviate

>'''p'''('''s'''&size(10){1};, ..., '''s'''&size(10){'''m'''};),
'''q'''('''t'''&size(10){1};, ..., '''t'''&size(10){'''n'''};)
>$$p(s_1,\dots,s_m),\ q(t_1,\dots,t_n)$$

to
>$$p(s_1,\dots,s_{k-1}, q(t_1,\dots,t_{n-1}),s_{k+1},\dots,s_m)$$

>'''p'''('''s'''&size(10){1};, ..., '''s'''&size(10){'''k'''-1};,
'''q'''('''t'''&size(10){1};, ..., '''t'''&size(10){'''n'''-1};),
'''s'''&size(10){'''k'''+1};, ..., '''s'''&size(10){'''m'''};)
// &math(p(s_1,\ldots,s_m),   q(t_1,\ldots,t_n)); to
// &math(p(s_1,\ldots,s_{k-1},q(t_1,\ldots,t_{n-1}), s_{k+1},\ldots,s_m));

if '''t'''&size(10){'''n'''}; and '''s'''&size(10){'''k'''}; are the same link name.  For example,
c(1,c(2,n),L0)
is an abbreviation of
c(A,L1,L0),c(B,L2,L1),n(L2),1(A),2(B).
if $$t_n$$ and $$s_k$$ are the same link name.  For example,
c(A,L1,L0),c(B,L2,L1),n(L2),1(A),2(B)
can be abbreviated to
c(1,c(2,n),L0).
This can be written also as
L0=c(1,c(2,n))
because the semantics of LMNtal regards c(1,c(2,n),L0) and L0=L1, c(1,c(2,n),L1)
as identical (see Connectors below) and we can apply term abbreviation to the latter to obtain L0=c(1,c(2,n)) .
because LMNtal regards c(1,c(2,n),L0) and L0=L1, c(1,c(2,n),L1)
as identical (see Connectors below) and we can use the term notation for the latter to obtain L0=c(1,c(2,n)) .

For an atom name '''p''' and a membrane,
'''p'''(..., {...}, ...) stands for a process
'''p'''(..., X, ...), {+X, ...} .
Abbreviated form is provided also for membranes.  For an atom name '''p''' and a membrane,
$$p(\dots, \{\dots\}, \dots)$$ stands for a process
$$p(\dots, X, \dots), \{\texttt{+}X, \dots\}$$ .

***List Notation
***List Notation [#vdc5469f]

The Prolog list syntax can be used in LMNtal.
List constructor atoms have three arguments and the name '.' .
For example,

'.'(A,Tmp,X), '.'(B,Rest,Tmp), '[]'(Rest)

can be abbreviated to both of the following:

X=[A,B|Rest], Rest=[]
and
X=[A,B]
are abbreviated forms of
'.'(A,Tmp,X), '.'(B,Rest,Tmp), '[]'(Rest).

//For some reason, the process [A,B|Rest] is parsed as
//'.'(A,Tmp), '.'(B,Rest,Tmp).
//These two atoms have different arities.

***Connectors
***Connectors [#kda889ac]

Binary atoms of the form X=Y are called ''connector atoms'' or ''connectors''.  A connector states that the two link names are considered identical (i.e., interconnected in zero steps).
Binary atoms of the form X=Y are called ''connectors''.  A connector states that the two links are interconnected (in zero steps).
// (in the sense of structural equivalence. Another instance of structural
// equivalence is the reordering of multiset elements.)
For example, ( p(A,X,C), X=B ) is equivalent to p(A,B,C),
For example, ( p(A,X,C), X=B ) is equivalent to p(A,B,C)
as well as to ( p(A,B,X), C=X ) and C=p(A,B).

Connectors are typically used in the base case of a recursive definition:

( append([],Y,Res)    :- Res=Y ),
( append([A|X],Y,Res) :- Res=[A|R], append(X,Y,R)] )

**Rules
**Rules [#f1dc70da]

The basic syntax of a rule is

>$$(\textit{Head}\ \texttt{:-}\ \textit{Body}\,)$$

The enclosing parentheses can be omitted if periods are used to delimit the rule. Both of '''Head''' and '''Body''' are ''process templates''.

The enclosing parentheses can be omitted if periods are used to terminate the rule. Both of '''Head''' and '''Body''' are ''process templates''.
'''Head''' specifies processes to be rewritten and
'''Body''' specifies the result of rewriting.
Rules work only for the processes residing in the same membrane.

The full syntax of a rule that contains '''Guards'''
will be explained later in [[a separate section>Guards]].
will be explained in [[a separate section>Guards]].

***Process Templates
***Process Templates [#r0006ac0]

A process template is a multiset of the following:

|BGCOLOR(white):syntactic&br;category|BGCOLOR(white):form|BGCOLOR(white):description|
|BGCOLOR(white): ''atoms'' | '''p'''('''X'''&size(10){1};, ..., '''X'''&size(10){'''n'''};) | same as in a process |
|BGCOLOR(white): ''cells'' | { '''Template''' }&br;{ '''Template''' }/&br;'''m'''{ '''Template''' }&br;'''m'''{ '''Template''' }/ | a process template enclosed with a membrane |
|BGCOLOR(white): ''rules'' | ( '''Head''' :- '''Body''' ) | allowed only in a Body |
|BGCOLOR(white): ''process contexts'' | $'''p'''&br;$'''p'''['''X'''&size(10){1};, ..., '''X'''&size(10){'''n'''};]&br;$'''p'''['''X'''&size(10){1};, ..., '''X'''&size(10){'''n'''};&#x7c;*'''X'''] | matches a multiset of atoms and cells (see below) | |BGCOLOR(white): ''rule contexts'' | @'''p''' | matches a multiset of rules | |BGCOLOR(white): ''atoms'' | $$p(X_1,\dots,X_n)$$ | same as in a process | |BGCOLOR(white): ''cells'' | $$\{\textit{Template}\,\}$$&br;$$\{\textit{Template}\,\}/$$&br;$$m\{\textit{Template}\,\}$$&br;$$m\{\textit{Template}\,\}/$$ | a process template enclosed with a membrane | |BGCOLOR(white): ''rules'' | $$(\textit{Head}\ \texttt{:-}\ \textit{Body}\,)$$ | allowed only in a Body | |BGCOLOR(white): ''process contexts'' | $$\texttt{\}p$$&br;$$\texttt{\}p\texttt{[}X_1,\dots,X_n\texttt{]}$$&br;$$\texttt{\}p\texttt{[}X_1,\dots,X_n\texttt{&#x7c;*}X\texttt{]}$$ | matches a multiset of atoms and cells (see below) | |BGCOLOR(white): ''rule contexts'' | $$@p$$ | matches a multiset of rules | A cell template with a membrane name only matches a cell with the same membrane name. A cell template with '/' (the stable flag) only matches a ''stable'' cell, i.e., a cell containing no applicable rules inside it. ***Process Contexts ***Process Contexts [#k6234793] A process context represents a multiset of atoms and cells. The arguments '''X'''&size(10){1};, ..., '''X'''&size(10){'''n'''}; specify A process context is a 'wildcard' for processes and represents a multiset of atoms and cells. The arguments $$X_1,\dots,X_n$$ specify the set of free links that must exist in the matched process. The optional '''*X''' represents an arbitrary number of extra free links. The optional $$*X$$ represents an arbitrary number of extra free links. The form$'''p''' is an abbreviation of $'''p'''[&#x7c;*'''X'''], i.e., The form $$\texttt{\}p$$ is an abbreviation of $$\texttt{\} p\texttt{[|*}X\texttt{]}$$, i.e., a multiset of atoms and cells with no constraints on the occurrences of free links. A process context must occur within a membrane in a head. Alternatively, it may either occur - in a head and an input position of a guard, or - in an output position of a guard. Process contexts of the latter kinds are called ''typed process contexts''; see [[Guards]] for details. You can abbreviate >$$p(s_1,\dots,s_{k-1},X,s_{k+1},\dots,s_m),\,\texttt{\}q\texttt{[}X\texttt{]}$$ >'''p'''('''s'''&size(10){1};, ..., '''s'''&size(10){'''k'''-1};, '''X''', '''s'''&size(10){'''k'''+1};, ..., '''s'''&size(10){'''m'''};),$'''q'''['''X''']

to
>$$p(s_1,\dots,s_{k-1},\texttt{\}q,s_{k+1},\dots,s_m)$$.

>'''p'''('''s'''&size(10){1};, ..., '''s'''&size(10){'''k'''-1};,
$'''q''', '''s'''&size(10){'''k'''+1};, ..., '''s'''&size(10){'''m'''};). //&math(p(s_1,\ldots,s_{k-1},X, s_{k+1},\ldots,s_m),\$q[X]); to
//&math(p(s_1,\ldots,s_{k-1},\\$q,s_{k+1},\ldots,s_m));.

//Note that the current implementation does not fully
// support process contexts with explicit arguments.