From 53d12a1596e49341d91c4168179477090cb7e3cd Mon Sep 17 00:00:00 2001 From: HOS Date: Mon, 3 Nov 2025 16:07:44 +0100 Subject: [PATCH 1/5] ProposeSolution --- chapters/annotations.tex | 2 ++ 1 file changed, 2 insertions(+) diff --git a/chapters/annotations.tex b/chapters/annotations.tex index 4f890afab..f6d13bca4 100644 --- a/chapters/annotations.tex +++ b/chapters/annotations.tex @@ -1744,6 +1744,8 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS If \lstinline!connectorSizing = true!, a tool may set the variable value in a modifier automatically, if used as dimension size of a vector of connectors. In that case the value modifier should not be edited directly by the user, and a tool may choose to not display that variable in the dialog or display it with disabled input field. +There should be one vector of connectors using the dimension size \lstinline!n! for each variable \lstinline!n! with \lstinline!connectorSizing = true!. +If there are other vector of connectors that should have the same size, but not cause an automatic update they can use \lstinline!n+0! instead. \begin{nonnormative} The \lstinline!connectorSizing! annotation is used in cases where connections to a vector of connectors shall be made and a new connection requires to resize the vector and to connect to the new index (unary connections). From 1beca9cb9f22c537b801c70b368e1d1dc3d78ab6 Mon Sep 17 00:00:00 2001 From: Hans Olsson Date: Tue, 4 Nov 2025 08:45:31 +0100 Subject: [PATCH 2/5] Update chapters/annotations.tex Co-authored-by: Henrik Tidefelt --- chapters/annotations.tex | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/chapters/annotations.tex b/chapters/annotations.tex index f6d13bca4..0468a0ece 100644 --- a/chapters/annotations.tex +++ b/chapters/annotations.tex @@ -1745,7 +1745,8 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS If \lstinline!connectorSizing = true!, a tool may set the variable value in a modifier automatically, if used as dimension size of a vector of connectors. In that case the value modifier should not be edited directly by the user, and a tool may choose to not display that variable in the dialog or display it with disabled input field. There should be one vector of connectors using the dimension size \lstinline!n! for each variable \lstinline!n! with \lstinline!connectorSizing = true!. -If there are other vector of connectors that should have the same size, but not cause an automatic update they can use \lstinline!n+0! instead. +Other vectors of connectors that need to have the same size may use a different expression with the same value, such as \lstinline!n + 0!, to avoid that multiple vectors become associated with the \lstinline!connectorSizing! automatic updating of \lstinline!n!. +(Note that non-connector vectors may have size \lstinline!n! without becoming associated.) \begin{nonnormative} The \lstinline!connectorSizing! annotation is used in cases where connections to a vector of connectors shall be made and a new connection requires to resize the vector and to connect to the new index (unary connections). From c2f08ff1d41fa7f5f9ce705bf96c4b9a4f158189 Mon Sep 17 00:00:00 2001 From: HOS Date: Tue, 4 Nov 2025 09:03:44 +0100 Subject: [PATCH 3/5] Reformulate --- chapters/annotations.tex | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/chapters/annotations.tex b/chapters/annotations.tex index 0468a0ece..abf4ebe9e 100644 --- a/chapters/annotations.tex +++ b/chapters/annotations.tex @@ -1744,7 +1744,7 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS If \lstinline!connectorSizing = true!, a tool may set the variable value in a modifier automatically, if used as dimension size of a vector of connectors. In that case the value modifier should not be edited directly by the user, and a tool may choose to not display that variable in the dialog or display it with disabled input field. -There should be one vector of connectors using the dimension size \lstinline!n! for each variable \lstinline!n! with \lstinline!connectorSizing = true!. +There shall be exactly one vector of connectors using the dimension size \lstinline!n! for each variable \lstinline!n! with \lstinline!connectorSizing = true!. Other vectors of connectors that need to have the same size may use a different expression with the same value, such as \lstinline!n + 0!, to avoid that multiple vectors become associated with the \lstinline!connectorSizing! automatic updating of \lstinline!n!. (Note that non-connector vectors may have size \lstinline!n! without becoming associated.) @@ -1752,6 +1752,10 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS The \lstinline!connectorSizing! annotation is used in cases where connections to a vector of connectors shall be made and a new connection requires to resize the vector and to connect to the new index (unary connections). The annotation allows a tool to perform these two actions in many cases automatically. This is, e.g., very useful for state machines and for certain components of fluid libraries. + +If there is not exactly one vector of connectors for a each variable \lstinline!n! with \lstinline!connectorSizing = true! diagnostics are needed, but the model may otherwise work. +If there are no vector of connectors for such a variable it should be removed. +Having multiple vector of connectors for such a variable will not work reliably for all graphical operations described below. \end{nonnormative} \begin{nonnormative} From e37d8bb4290cec0495bc82714baf2aece8d3b234 Mon Sep 17 00:00:00 2001 From: Hans Olsson Date: Tue, 4 Nov 2025 09:29:21 +0100 Subject: [PATCH 4/5] Update chapters/annotations.tex Co-authored-by: Henrik Tidefelt --- chapters/annotations.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chapters/annotations.tex b/chapters/annotations.tex index abf4ebe9e..293c910ba 100644 --- a/chapters/annotations.tex +++ b/chapters/annotations.tex @@ -1753,7 +1753,7 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS The annotation allows a tool to perform these two actions in many cases automatically. This is, e.g., very useful for state machines and for certain components of fluid libraries. -If there is not exactly one vector of connectors for a each variable \lstinline!n! with \lstinline!connectorSizing = true! diagnostics are needed, but the model may otherwise work. +If a variable \lstinline!n! with \lstinline!connectorSizing = true! does not have exactly one associated vector of connectors, a diagnostic is recommended. If there are no vector of connectors for such a variable it should be removed. Having multiple vector of connectors for such a variable will not work reliably for all graphical operations described below. \end{nonnormative} From 2a91e9e3fd36833e041a824d663bd1767199ab63 Mon Sep 17 00:00:00 2001 From: HOS Date: Wed, 5 Nov 2025 16:34:09 +0100 Subject: [PATCH 5/5] AlmostAsSuggest --- chapters/annotations.tex | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/chapters/annotations.tex b/chapters/annotations.tex index 293c910ba..30bc0a533 100644 --- a/chapters/annotations.tex +++ b/chapters/annotations.tex @@ -1753,9 +1753,8 @@ \subsection{Connector Sizing}\label{connector-sizing}\annotationindex{connectorS The annotation allows a tool to perform these two actions in many cases automatically. This is, e.g., very useful for state machines and for certain components of fluid libraries. -If a variable \lstinline!n! with \lstinline!connectorSizing = true! does not have exactly one associated vector of connectors, a diagnostic is recommended. -If there are no vector of connectors for such a variable it should be removed. -Having multiple vector of connectors for such a variable will not work reliably for all graphical operations described below. +If a variable \lstinline!n! with \lstinline!connectorSizing = true! has multiple associated vectors of connectors, some of the graphical operations described below will not work reliably. +If there is no associated vector of connectors, the user may choose to address this by removing the \lstinline!connectorSizing! annotation or the entire variable. \end{nonnormative} \begin{nonnormative}