WOLFRAM

Wolfram言語 ＆ システムドキュメントセンター

MergingFunction

TimeSeries，PersistentSymbol等の関数のオプションで，値のリストに適用する関数を指定する．

詳細
Details and Options Details and Options
例題  
例  
スコープ  
時系列  
事象系列  
永続シンボル  
関連項目
関連するガイド
履歴
引用書式

MergingFunction

MergingFunction

TimeSeries，PersistentSymbol等の関数のオプションで，値のリストに適用する関数を指定する．

詳細

  • MergingFunctionは，通常，繰返し，代替，集約が生じ得る場合に，値のリストを処理するために用いられる．
  • マージ関数は，与えられた値のリストを受け取り，別のリスト，またはそれらの値を一つに結合した単一の値を返すことができる．
  • 別のリストを返すMergingFunctionに対する一般的な設定には次のものが含まれる．
  • Identityすべての値のリストを返す
    Flattenすべての値の平坦化したリストを返す
    Union重複がないソートされたリストを返す
    DeleteDuplicates重複がないもとのリストを返す
  • 次は，単一の値を返すMergingFunctionでよく使われる設定である．
  • First最初の値だけを返す
    Last最後の値だけを返す
    Apply[MissingFallback]Missingではない最初の値を返す
    Merge[f]関数 f を使って連想をマージする
  • 数値のリストに対して単一の値を返す他の一般的な設定には次のものが含まれる．
  • Meanすべての値の平均を返す
    Medianすべての値の中央値を返す
    Min最小値を返す
    Max最大値を返す
    Totalすべての値の合計を返す

例題

すべて開く すべて閉じる

例  (3)

デフォルトで，TimeSeriesは重複するタイムスタンプの平均を取る：

Wolfram Language code: TimeSeries[{1, 2, 3, 4, 5}, {{4.2, 4.2, 5.3, 6.1, 6.1}}]
Wolfram Language code: Normal[%]

対応する値の合計を取る：

Wolfram Language code: TimeSeries[{1, 2, 3, 4, 5}, {{4.2, 4.2, 5.3, 6.1, 6.1}}, MergingFunction -> Total]// Normal

キー"pval"を持つたくさんの永続値を，さまざまな永続値の場所に作る：

Wolfram Language code: PersistentSymbol["pval", "FrontEndSession"] = 1; PersistentSymbol["pval", "Local"] = 2;

$PersistencePathに存在するすべての値を与える：

Wolfram Language code: PersistentSymbol["pval", MergingFunction -> Identity]

求まった最初の値だけを与える：

Wolfram Language code: PersistentSymbol["pval", MergingFunction -> First]

キー"lval"を持つたくさんの永続値を，さまざまな永続値の場所に作る：

Wolfram Language code: PersistentSymbol["lval", "KernelSession"] = {11, 12}; PersistentSymbol["lval", "FrontEndSession"] = {}; PersistentSymbol["lval", "Local"] = {1, {2, 12}};

求まったすべての値のリストを与える：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Identity]

リストされた値を繋ぐ：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Apply[Join]]

すべての部分リストを平らにする：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Flatten]

スコープ  (5)

時系列  (1)

デフォルトで，TimeSeriesは重複するタイムスタンプの平均値を取る：

Wolfram Language code: values = Quantity[{20, 22, 21, 23, 22}, "Millimeters"];
Wolfram Language code: times = {Yesterday, Today, Tomorrow, Today, Tomorrow};
Wolfram Language code: TimeSeries[values, {times}]
Wolfram Language code: Normal[%]

対応する値の最大値を取る：

Wolfram Language code: TimeSeries[values, {times}, MergingFunction -> Max]// Normal

事象系列  (1)

デフォルトで，EventSeriesは時点と値のペアすべてを，重複する時点も含めて保存する：

Wolfram Language code: values = RandomWord[5]
Wolfram Language code: times = RandomDate[Quantity[-3, "Days"], 5, DateGranularity -> "Day"]
Wolfram Language code: EventSeries[values, {times}]// Normal

各タイムスタンプの最初の値を取る：

Wolfram Language code: EventSeries[values, {times}, MergingFunction -> First]// Normal

同じタイムスタンプに対応する値をグループ化する：

Wolfram Language code: EventSeries[values, {times}, MergingFunction -> Identity]// Normal

永続シンボル  (3)

キー"lval"を持つさまざまな位置にある永続値の補数を作る：

Wolfram Language code: PersistentSymbol["lval", "FrontEndSession"] = {}; PersistentSymbol["lval", "KernelSession"] = {11, 12}; PersistentSymbol["lval", "Local"] = {1, {2, 12}};

$PersistencePathにあってキー"lval"を持つ既存の値をすべてリストにする：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Identity]

デフォルトで，最初の値だけが返される：

Wolfram Language code: PersistentSymbol["lval"]

すべての部分リストを繋いで平らにする：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Flatten]

すべての部分リストを繋ぎ合せる：

Wolfram Language code: PersistentSymbol["lval", MergingFunction -> Apply[Join]]

"aval"という名のさまざまな位置にある永続的な連想の補数を作る：

Wolfram Language code: PersistentSymbol["aval", "FrontEndSession"] = <|"key1" -> 2, "key2" -> {3, 4}|>; PersistentSymbol["aval", "KernelSession"] = <|"key1" -> 3|>; PersistentSymbol["aval", "Local"] = <|"key2" -> 2, "key3" -> {8, 9}|>;

$PersistencePathにあるすべての値をリストにする：

Wolfram Language code: PersistentSymbol["aval", MergingFunction -> Identity]

連想中の同一のキーをマージする：

Wolfram Language code: PersistentSymbol["aval", MergingFunction -> Merge[Flatten]]

カスタムのマージ関数で"mylist"のデフォルト値を定義する：

Wolfram Language code: PersistentSymbol["mylist", "Installation"] = {};
Wolfram Language code: io = PersistentObject["mylist", "Installation"]
Wolfram Language code: io["MergingFunction"] = Flatten;

さまざまな永続値の場所の追加的な値を定義する：

Wolfram Language code: PersistentSymbol["mylist", "Local"] = 3; PersistentSymbol["mylist", "FrontEndSession"] = {1, 2};

値の検索をする際，カスタムのマージ関数が使われるようになった：

Wolfram Language code: PersistentSymbol["mylist"]
Wolfram Research (2017), MergingFunction, Wolfram言語関数， https://reference.wolfram.com/language/ref/MergingFunction.html （2026年に更新）.

テキスト

Wolfram Research (2017), MergingFunction, Wolfram言語関数， https://reference.wolfram.com/language/ref/MergingFunction.html （2026年に更新）.

CMS

Wolfram Language. 2017. "MergingFunction." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2026. https://reference.wolfram.com/language/ref/MergingFunction.html.

APA

Wolfram Language. (2017). MergingFunction. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/MergingFunction.html

BibTeX

@misc{reference.wolfram_2026_mergingfunction, author="Wolfram Research", title="{MergingFunction}", year="2026", howpublished="\url{https://reference.wolfram.com/language/ref/MergingFunction.html}", note=[Accessed: 02-November-2026]}

BibLaTeX

@online{reference.wolfram_2026_mergingfunction, organization={Wolfram Research}, title={MergingFunction}, year={2026}, url={https://reference.wolfram.com/language/ref/MergingFunction.html}, note=[Accessed: 02-November-2026]}