Merge pull request #21 from Comfy-Org/ClipMergeSimple

Update ClipMergeSimple node docs

Author: comfyui-wiki

comfyui_embedded_docs/docs/ClipMergeSimple/en.md

@@ -1,15 +1,40 @@
+`CLIPMergeSimple` is an advanced model merging node used to combine two CLIP text encoder models based on a specified ratio.
+
 This node specializes in merging two CLIP models based on a specified ratio, effectively blending their characteristics. It selectively applies patches from one model to another, excluding specific components like position IDs and logit scale, to create a hybrid model that combines features from both source models.
 
 ## Inputs
 
-| Parameter | Data Type   | Description |
-|-----------|-------------|-------------|
-| `clip1`   | `CLIP`      | The first CLIP model to be merged. It serves as the base model for the merging process. |
-| `clip2`   | `CLIP`      | The second CLIP model to be merged. Its key patches, except for position IDs and logit scale, are applied to the first model based on the specified ratio. |
-| `ratio`   | `FLOAT`     | Determines the proportion of features from the second model to blend into the first model. A ratio of 1.0 means fully adopting the second model's features, while 0.0 retains only the first model's features. |
+| Parameter | Data Type | Description |
+|-----------|-----------|-------------|
+| `clip1`   | CLIP      | The first CLIP model to be merged. It serves as the base model for the merging process. |
+| `clip2`   | CLIP      | The second CLIP model to be merged. Its key patches, except for position IDs and logit scale, are applied to the first model based on the specified ratio. |
+| `ratio`   | FLOAT     | Range `0.0 - 1.0`, determines the proportion of features from the second model to blend into the first model. A ratio of 1.0 means fully adopting the second model's features, while 0.0 retains only the first model's features. |
 
 ## Outputs
 
-| Parameter | Data Type   | Description |
-|-----------|-------------|-------------|
+| Parameter | Data Type | Description |
+|-----------|-----------|-------------|
 | `clip`    | CLIP      | The resulting merged CLIP model, incorporating features from both input models according to the specified ratio. |
+
+## Merging Mechanism Explained
+
+### Merging Algorithm
+
+The node uses weighted averaging to merge the two models:
+
+1. **Clone Base Model**: First clones `clip1` as the base model
+2. **Get Patches**: Obtains all key patches from `clip2`
+3. **Filter Special Keys**: Skips keys ending with `.position_ids` and `.logit_scale`
+4. **Apply Weighted Merge**: Uses the formula `(1.0 - ratio) * clip1 + ratio * clip2`
+
+### Ratio Parameter Explained
+
+- **ratio = 0.0**: Fully uses clip1, ignores clip2
+- **ratio = 0.5**: 50% contribution from each model
+- **ratio = 1.0**: Fully uses clip2, ignores clip1
+
+## Use Cases
+
+1. **Model Style Fusion**: Combine characteristics of CLIP models trained on different data
+2. **Performance Optimization**: Balance strengths and weaknesses of different models
+3. **Experimental Research**: Explore combinations of different CLIP encoders

comfyui_embedded_docs/docs/ClipMergeSimple/es.md

@@ -1,15 +1,40 @@
+`CLIPMergeSimple` es un nodo avanzado de fusión de modelos utilizado para combinar dos modelos codificadores de texto CLIP basándose en una proporción especificada.
+
 Este nodo se especializa en fusionar dos modelos CLIP basándose en una proporción especificada, combinando efectivamente sus características. Aplica selectivamente parches de un modelo a otro, excluyendo componentes específicos como los IDs de posición y la escala de logit, para crear un modelo híbrido que combina características de ambos modelos fuente.
 
 ## Entradas
 
 | Parámetro | Tipo de Dato | Descripción |
 |-----------|-------------|-------------|
-| `clip1`   | `CLIP`      | El primer modelo CLIP que se va a fusionar. Sirve como el modelo base para el proceso de fusión. |
-| `clip2`   | `CLIP`      | El segundo modelo CLIP que se va a fusionar. Sus parches clave, excepto los IDs de posición y la escala de logit, se aplican al primer modelo según la proporción especificada. |
-| `ratio`   | `FLOAT`     | Determina la proporción de características del segundo modelo que se fusionarán en el primer modelo. Una proporción de 1.0 significa adoptar completamente las características del segundo modelo, mientras que 0.0 retiene solo las características del primer modelo. |
+| `clip1`   | CLIP      | El primer modelo CLIP que se va a fusionar. Sirve como el modelo base para el proceso de fusión. |
+| `clip2`   | CLIP      | El segundo modelo CLIP que se va a fusionar. Sus parches clave, excepto los IDs de posición y la escala de logit, se aplican al primer modelo según la proporción especificada. |
+| `ratio`   | FLOAT     | Rango `0.0 - 1.0`, determina la proporción de características del segundo modelo que se fusionarán en el primer modelo. Una proporción de 1.0 significa adoptar completamente las características del segundo modelo, mientras que 0.0 retiene solo las características del primer modelo. |
 
 ## Salidas
 
 | Parámetro | Tipo de Dato | Descripción |
 |-----------|-------------|-------------|
 | `clip`    | CLIP      | El modelo CLIP resultante de la fusión, que incorpora características de ambos modelos de entrada según la proporción especificada. |
+
+## Explicación del Mecanismo de Fusión
+
+### Algoritmo de Fusión
+
+El nodo utiliza un promedio ponderado para fusionar los dos modelos:
+
+1. **Clonar Modelo Base**: Primero clona `clip1` como modelo base
+2. **Obtener Parches**: Obtiene todos los parches clave de `clip2`
+3. **Filtrar Claves Especiales**: Omite las claves que terminan en `.position_ids` y `.logit_scale`
+4. **Aplicar Fusión Ponderada**: Utiliza la fórmula `(1.0 - ratio) * clip1 + ratio * clip2`
+
+### Explicación del Parámetro Ratio
+
+- **ratio = 0.0**: Utiliza completamente clip1, ignora clip2
+- **ratio = 0.5**: 50% de contribución de cada modelo
+- **ratio = 1.0**: Utiliza completamente clip2, ignora clip1
+
+## Casos de Uso
+
+1. **Fusión de Estilos de Modelos**: Combinar características de modelos CLIP entrenados con diferentes datos
+2. **Optimización de Rendimiento**: Equilibrar fortalezas y debilidades de diferentes modelos
+3. **Investigación Experimental**: Explorar combinaciones de diferentes codificadores CLIP

comfyui_embedded_docs/docs/ClipMergeSimple/fr.md

@@ -1,15 +1,40 @@
+`CLIPMergeSimple` est un nœud avancé de fusion de modèles utilisé pour combiner deux modèles d'encodeur de texte CLIP selon un ratio spécifié.
+
 Ce nœud se spécialise dans la fusion de deux modèles CLIP selon un ratio spécifié, mélangeant efficacement leurs caractéristiques. Il applique sélectivement des patches d'un modèle à un autre, en excluant des composants spécifiques comme les IDs de position et l'échelle des logits, pour créer un modèle hybride qui combine les caractéristiques des deux modèles sources.
 
 ## Entrées
 
 | Paramètre | Type de Donnée | Description |
 |-----------|-------------|-------------|
-| `clip1`   | `CLIP`      | Le premier modèle CLIP à fusionner. Il sert de modèle de base pour le processus de fusion. |
-| `clip2`   | `CLIP`      | Le second modèle CLIP à fusionner. Ses patches clés, à l'exception des IDs de position et de l'échelle des logits, sont appliqués au premier modèle selon le ratio spécifié. |
-| `ratio`   | `FLOAT`     | Détermine la proportion de caractéristiques du second modèle à intégrer dans le premier modèle. Un ratio de 1.0 signifie adopter entièrement les caractéristiques du second modèle, tandis que 0.0 conserve uniquement les caractéristiques du premier modèle. |
+| clip1     | CLIP      | Le premier modèle CLIP à fusionner. Il sert de modèle de base pour le processus de fusion. |
+| clip2     | CLIP      | Le second modèle CLIP à fusionner. Ses patches clés, à l'exception des IDs de position et de l'échelle des logits, sont appliqués au premier modèle selon le ratio spécifié. |
+| ratio     | FLOAT     | Plage `0.0 - 1.0`, détermine la proportion de caractéristiques du second modèle à intégrer dans le premier modèle. Un ratio de 1.0 signifie adopter entièrement les caractéristiques du second modèle, tandis que 0.0 conserve uniquement les caractéristiques du premier modèle. |
 
 ## Sorties
 
 | Paramètre | Type de Donnée | Description |
 |-----------|-------------|-------------|
-| `clip`    | CLIP      | Le modèle CLIP fusionné résultant, incorporant des caractéristiques des deux modèles d'entrée selon le ratio spécifié. |
+| clip      | CLIP      | Le modèle CLIP fusionné résultant, incorporant des caractéristiques des deux modèles d'entrée selon le ratio spécifié. |
+
+## Explication du Mécanisme de Fusion
+
+### Algorithme de Fusion
+
+Le nœud utilise une moyenne pondérée pour fusionner les deux modèles :
+
+1. **Clonage du Modèle de Base** : Clone d'abord clip1 comme modèle de base
+2. **Obtention des Patches** : Obtient tous les patches clés de clip2
+3. **Filtrage des Clés Spéciales** : Ignore les clés se terminant par `.position_ids` et `.logit_scale`
+4. **Application de la Fusion Pondérée** : Utilise la formule `(1.0 - ratio) * clip1 + ratio * clip2`
+
+### Explication du Paramètre Ratio
+
+- **ratio = 0.0** : Utilise entièrement clip1, ignore clip2
+- **ratio = 0.5** : Contribution de 50% de chaque modèle
+- **ratio = 1.0** : Utilise entièrement clip2, ignore clip1
+
+## Cas d'Utilisation
+
+1. **Fusion de Styles de Modèles** : Combiner les caractéristiques des modèles CLIP entraînés sur différentes données
+2. **Optimisation des Performances** : Équilibrer les forces et les faiblesses de différents modèles
+3. **Recherche Expérimentale** : Explorer les combinaisons de différents encodeurs CLIP

comfyui_embedded_docs/docs/ClipMergeSimple/ja.md

@@ -1,15 +1,40 @@
+`CLIPマージシンプル`は、指定された比率に基づいて2つのCLIPテキストエンコーダーモデルを組み合わせるための高度なモデル統合ノードです。
+
 このノードは、指定された比率に基づいて2つのCLIPモデルを統合し、それらの特性を効果的にブレンドします。位置IDやロジットスケールなどの特定のコンポーネントを除外し、一方のモデルからもう一方のモデルにパッチを選択的に適用することで、両方のソースモデルの特徴を組み合わせたハイブリッドモデルを作成します。
 
 ## 入力
 
 | パラメータ | データ型 | 説明 |
 |-----------|-------------|-------------|
-| `clip1`   | `CLIP`      | 統合される最初のCLIPモデルです。統合プロセスのベースモデルとして機能します。 |
-| `clip2`   | `CLIP`      | 統合される2番目のCLIPモデルです。位置IDやロジットスケールを除く主要なパッチが、指定された比率に基づいて最初のモデルに適用されます。 |
-| `ratio`   | `FLOAT`     | 2番目のモデルの特徴を最初のモデルにどの程度ブレンドするかを決定します。比率が1.0の場合、2番目のモデルの特徴を完全に採用し、0.0の場合は最初のモデルの特徴のみを保持します。 |
+| clip1     | CLIP      | 統合される最初のCLIPモデルです。統合プロセスのベースモデルとして機能します。 |
+| clip2     | CLIP      | 統合される2番目のCLIPモデルです。位置IDやロジットスケールを除く主要なパッチが、指定された比率に基づいて最初のモデルに適用されます。 |
+| 比率      | FLOAT     | 範囲 `0.0 - 1.0`、2番目のモデルの特徴を最初のモデルにどの程度ブレンドするかを決定します。比率が1.0の場合、2番目のモデルの特徴を完全に採用し、0.0の場合は最初のモデルの特徴のみを保持します。 |
 
 ## 出力
 
 | パラメータ | データ型 | 説明 |
 |-----------|-------------|-------------|
-| `clip`    | CLIP      | 指定された比率に従って、両方の入力モデルの特徴を組み込んだ結果の統合CLIPモデルです。 |
+| clip      | CLIP      | 指定された比率に従って、両方の入力モデルの特徴を組み込んだ結果の統合CLIPモデルです。 |
+
+## 統合メカニズムの説明
+
+### 統合アルゴリズム
+
+このノードは、2つのモデルを統合するために重み付け平均を使用します：
+
+1. **ベースモデルのクローン**: まずclip1をベースモデルとしてクローンします
+2. **パッチの取得**: clip2からすべての主要なパッチを取得します
+3. **特殊キーのフィルタリング**: `.position_ids`と`.logit_scale`で終わるキーをスキップします
+4. **重み付け統合の適用**: `(1.0 - 比率) * clip1 + 比率 * clip2`の式を使用します
+
+### 比率パラメータの説明
+
+- **比率 = 0.0**: clip1を完全に使用し、clip2を無視します
+- **比率 = 0.5**: 各モデルから50%の寄与
+- **比率 = 1.0**: clip2を完全に使用し、clip1を無視します
+
+## 使用例
+
+1. **モデルスタイルの融合**: 異なるデータで訓練されたCLIPモデルの特徴を組み合わせる
+2. **パフォーマンスの最適化**: 異なるモデルの長所と短所のバランスを取る
+3. **実験的研究**: 異なるCLIPエンコーダーの組み合わせを探る

comfyui_embedded_docs/docs/ClipMergeSimple/ko.md

@@ -1,15 +1,40 @@
+`CLIP 병합 (단순)`은 지정된 비율에 따라 두 개의 CLIP 텍스트 인코더 모델을 결합하는 고급 모델 병합 노드입니다.
+
 이 노드는 지정된 비율에 따라 두 개의 CLIP 모델을 병합하여 그들의 특성을 효과적으로 혼합합니다. 위치 ID와 로그 스케일과 같은 특정 구성 요소를 제외하고 한 모델에서 다른 모델로 패치를 선택적으로 적용하여 두 소스 모델의 기능을 결합한 하이브리드 모델을 만듭니다.
 
 ## 입력
 
-| パラメータ | 데이터 유형 | 説明 |
+| 매개변수 | 데이터 유형 | 설명 |
 |-----------|-------------|-------------|
-| `clip1`   | `CLIP`      | 병합될 첫 번째 CLIP 모델입니다. 병합 과정의 기본 모델로 사용됩니다. |
-| `clip2`   | `CLIP`      | 병합될 두 번째 CLIP 모델입니다. 위치 ID와 로그 스케일을 제외한 주요 패치가 지정된 비율에 따라 첫 번째 모델에 적용됩니다. |
-| `ratio`   | `FLOAT`     | 두 번째 모델의 기능을 첫 번째 모델에 혼합할 비율을 결정합니다. 비율이 1.0이면 두 번째 모델의 기능을 완전히 채택하고, 0.0이면 첫 번째 모델의 기능만 유지합니다. |
+| CLIP1     | CLIP      | 병합될 첫 번째 CLIP 모델입니다. 병합 과정의 기본 모델로 사용됩니다. |
+| CLIP2     | CLIP      | 병합될 두 번째 CLIP 모델입니다. 위치 ID와 로그 스케일을 제외한 주요 패치가 지정된 비율에 따라 첫 번째 모델에 적용됩니다. |
+| 비율      | FLOAT     | 범위 `0.0 - 1.0`, 두 번째 모델의 기능을 첫 번째 모델에 혼합할 비율을 결정합니다. 비율이 1.0이면 두 번째 모델의 기능을 완전히 채택하고, 0.0이면 첫 번째 모델의 기능만 유지합니다. |
 
 ## 출력
 
-| パラメータ | 데이터 유형 | 説明 |
+| 매개변수 | 데이터 유형 | 설명 |
 |-----------|-------------|-------------|
-| `clip`    | CLIP      | 지정된 비율에 따라 두 입력 모델의 기능을 통합한 결과 병합된 CLIP 모델입니다. |
+| clip      | CLIP      | 지정된 비율에 따라 두 입력 모델의 기능을 통합한 결과 병합된 CLIP 모델입니다. |
+
+## 병합 메커니즘 설명
+
+### 병합 알고리즘
+
+이 노드는 두 모델을 병합하기 위해 가중 평균을 사용합니다:
+
+1. **기본 모델 복제**: 먼저 CLIP1을 기본 모델로 복제합니다
+2. **패치 획득**: CLIP2에서 모든 주요 패치를 획득합니다
+3. **특수 키 필터링**: `.position_ids`와 `.logit_scale`로 끝나는 키를 건너뜁니다
+4. **가중 병합 적용**: `(1.0 - 비율) * CLIP1 + 비율 * CLIP2` 공식을 사용합니다
+
+### 비율 매개변수 설명
+
+- **비율 = 0.0**: CLIP1을 완전히 사용하고 CLIP2를 무시합니다
+- **비율 = 0.5**: 각 모델에서 50%의 기여도
+- **비율 = 1.0**: CLIP2를 완전히 사용하고 CLIP1을 무시합니다
+
+## 사용 사례
+
+1. **모델 스타일 융합**: 서로 다른 데이터로 학습된 CLIP 모델의 특성 결합
+2. **성능 최적화**: 서로 다른 모델의 장단점 균형 조정
+3. **실험적 연구**: 다양한 CLIP 인코더의 조합 탐색