notes

Author: konn

docs/en/releases/unreleased.ipynb

@@ -54,12 +54,7 @@ def problem(problem):
 problem
 ```
 
-Comprehensions used with `jm.genarray` MUST satisfy the following conditions:
-
-1. It must be a **generator expression** enclosed in parentheses (or omitted). List comprehensions enclosed in `[ ]` are not supported.
-2. The `for` clause must be a single loop of the form `for p in e`, where `e` is a natural-number expression or tuple expression of natural numbers, and `p` is a pattern.
-   + `p` may be any pattern that matches `e`.
-
+Only one `for .. in ...` clause is allowed in a `genarray` comprehension.
 The following is an example that raises an error because it uses multiple `for` clauses:
 
 ```{code-cell} ipython3
@@ -76,25 +71,6 @@ except SyntaxError as e:
     print(str(e))
 ```
 
-Also, the right-hand side of `in` in `genarray` specifies only the shape.
-In particular, be careful not to use `jm.product` as shown below, because it creates a set and results in an error:
-
-```{code-cell} ipython3
-try:
-
-    @jm.Problem.define("genarray example")
-    def _(problem):
-        N = problem.Natural()
-        M = problem.Natural()
-        a = problem.Float(shape=(N, M))
-        x = problem.BinaryVar(shape=N)
-        Sums = problem.NamedExpr(
-            jm.genarray(a[i, j] * x[i] for i, j in jm.product(N, M))
-        )
-except Exception as e:
-    print(str(e))
-```
-
 ### Support for `min` / `max` along axes
 
 Previously, {py:func}`jm.sum <jijmodeling.sum>` and {py:meth}`Expression.sum <jijmodeling.Expression.sum>` supported taking sums along a specific axis of a multidimensional array via the `axis` keyword argument.

docs/ja/releases/unreleased.ipynb

@@ -54,12 +54,7 @@ def problem(problem):
 problem
 ```
 
-`jm.genarray` で使える内包表記は以下の条件に従う必要があります：
-
-1. 丸括弧で囲まれた**ジェネレータ式**であること。 `[ ]` で囲まれたリスト内包表記は利用できません。
-2. `for` 部は自然数式または自然数のタプル式 `e` パターン `p` に対し、 `for p in e` の形の単一のループであること。
-   + `p` は `E` に合致するパターンであれば何でも構いません。
-
+`genarray` の内包表記では、`for .. in ...` は一つしか許容されません。
 以下は、複数の `for`-節を使ってしまい、エラーになっている例です：
 
 ```{code-cell} ipython3
@@ -76,25 +71,6 @@ except SyntaxError as e:
     print(str(e))
 ```
 
-また、`genarray` の `in` の右辺はあくまでもシェイプを指定するものです。
-特に、以下のように`jm.product` を使ってしまうと集合になってしまい、エラーとなるので注意してください：
-
-```{code-cell} ipython3
-try:
-
-    @jm.Problem.define("genarray example")
-    def _(problem):
-        N = problem.Natural()
-        M = problem.Natural()
-        a = problem.Float(shape=(N, M))
-        x = problem.BinaryVar(shape=N)
-        Sums = problem.NamedExpr(
-            jm.genarray(a[i, j] * x[i] for i, j in jm.product(N, M))
-        )
-except Exception as e:
-    print(str(e))
-```
-
 ## 軸に沿った `min` / `max` のサポート
 
 旧来は {py:func}`jm.sum <jijmodeling.sum>` や {py:meth}`Expression.sum <jijmodeling.Expression.sum>` では `axis` キーワード引数により、多次元配列の特定の軸に沿った和を取ることができましたが、今回のバージョンからは {py:func}`jm.min <jijmodeling.min>` と {py:func}`jm.max <jijmodeling.max>`（そしてその対応する `Expression` メソッド）にも同様の機能が追加されました。