Skip to content

Non-normatively give rough explanation of 'tunable parameter' #3867

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
henrikt-ma wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Non-normatively give rough explanation of 'tunable parameter' #3867

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion chapters/classes.tex
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -426,7 +426,7 @@ \section{Component Variability}\label{component-variability}
A variable \lstinline!np! declared with the \lstinline!parameter!\indexinline{parameter} prefix, is called a \firstuse[parameter!non-evaluable]{non-evaluable parameter variable}\index{component variability!non-evaluable parameter} unless it is an evaluable parameter.
It is also simply called a \firstuse[---]{non-evaluable parameter}.
It does not change during transient analysis, with a value determined by the initialization problem.
For further details, see \ref{parameters}.
For further details and tool-specific exceptions, see \ref{parameters}.
\item
A \firstuse[discrete-time!variable]{discrete-time variable}\index{component variability!discrete-time} \lstinline!vd! is a variable that is discrete-valued (that is, not of \lstinline!Real! type) or assigned in a \lstinline!when!-clause.
The \lstinline!discrete!\indexinline{discrete} prefix may be used to clarify that a variable is discrete-time.
Expand Down Expand Up @@ -583,6 +583,15 @@ \subsection{Parameters}\label{parameters}
Here, a good error message for the variability error can include the information that the reason for \lstinline!n! being a non-evaluable parameter is that it has a dependency on the non-evaluable parameter \lstinline!b!.
\end{nonnormative}

\begin{nonnormative}
A variant of parameter component variability which is in use, but with tool-dependent meaning, is \firstuse{tunable parameter}.
Despite the rule that a parameter (evaluable or not) does not change during transient analysis, the idea is that some parameters still would be possible to change at events during transient analysis.
When a tool identifies such a parameter, it is often referred to as a \emph{tunable parameter}.
Both evaluable and non-evaluable parameters can be tunable.
Similar to other parameter component variabilities, some of the tunable parameters may be directly assigned at the events, whereas other tunable parameters will only be updated as a consequence of the direct assignments.
Note that the criterion of being possible to change at an event, as well as the related the semantics of making a change, are tool-dependent.
\end{nonnormative}

\begin{nonnormative}
Related to evaluable parameters, the term \firstuse{structural parameter} is also used in the Modelica community.
This term has no meaning defined by the specification, and the meaning may vary from one context to another.
Expand Down