# PPLCNetV4 PPLCNetV4 は、バックボーンネットワークとしてのみ提供されています。事前学習済みの画像分類チェックポイントは、公式にはリリースされていません。 ## PPLCNetV4Config[[transformers.PPLCNetV4Config]] #### transformers.PPLCNetV4Config[[transformers.PPLCNetV4Config]] ```python transformers.PPLCNetV4Config(transformers_version: str | None = None, architectures: list[str] | None = None, output_hidden_states: bool | None = False, return_dict: bool | None = True, dtype: str | torch.dtype | None = None, chunk_size_feed_forward: int = 0, is_encoder_decoder: bool = False, id2label: dict[int, str] | dict[str, str] | None = None, label2id: dict[str, int] | dict[str, str] | None = None, problem_type: Literal['regression', 'single_label_classification', 'multi_label_classification'] | None = None, scale: float | int = 1.0, block_configs: list | None = None, stem_channels: list[int] | tuple[int, ...] = (3, 48, 96), reduction: int = 4, hidden_act: str = 'relu', _out_features: list[str] | None = None, _out_indices: list[int] | None = None, num_channels: int = 3, stem_strides: Sequence = (2, 1, 1, 2, 1), stem_type: str = 'large', use_learnable_affine_block: bool = False) ``` [ソース](https://github.com/huggingface/transformers/blob/main/src/transformers/models/pp_lcnet_v4/configuration_pp_lcnet_v4.py#L33) **パラメータ:** scale (`float`, *optional*, デフォルト値は 1.0) : モデルのチャネル次元のスケーリング係数です。全体のアーキテクチャを変更せずに、モデルサイズと計算コストを調整するために使用されます（例: 0.25、0.5、1.0、1.5）。 block_configs (`list[list[tuple]]`、*任意*、デフォルトは`None`) : 各ステージの各ブロックの設定。各タプルには以下が含まれます: (kernel_size, in_channels, out_channels, stride, use_squeeze_excitation)。`None`の場合、デフォルトのPP-LCNet設定が使用されます。 stem_channels (`list[int]`、*optional*、デフォルトは`[3, 48, 96]`) : ステム層のチャネル次元です。 - 最初の数値（3）は入力画像のチャネル数 - 2番目の数値（48）は中間ステムのチャネル数 - 3番目の数値（96）は出力ステムのチャネル数 reduction (`int`, *optional*, デフォルトは 4) : squeeze-and-excitation (SE) ブロックにおける特徴チャネル次元の縮小係数です。特徴の表現力を維持しつつ、モデルのパラメータ数と計算複雑度を低減するために使用されます。 hidden_act (`str`、*任意*、デフォルトは `relu`) : デコーダーで使用する非線形活性化関数（関数または文字列）。例えば、`"gelu"`、`"relu"`、`"silu"` など。 num_channels (`int`、*任意*、デフォルトは`3`) : 入力チャネル数。 stem_strides (`Sequence[int | list[int] | tuple[int, ...]]`、*任意*、デフォルトは`(2, 1, 1, 2, 1)`) : ステム層のストライドパターンです。 stem_type (`str`、*任意*、デフォルトは`large`) : 使用するステム層の種類。以下のいずれかになります: - `"large"`: 標準のPP-LCNetV4ステム。 - `"small"`: チャネル次元が小さいバリアント。 use_learnable_affine_block (`bool`、*任意*、デフォルトは`False`) : ネットワーク内で Learnable Affine Blocks (LAB) を使用するかどうかを指定します。LAB は、特定の操作の後に学習可能なスケールとバイアスのパラメータを追加します。 これは、Pp Lcnet V4Model の設定を保存するための設定クラスです。指定された引数に基づいて Pp Lcnet V4 モデルをインスタンス化し、モデルのアーキテクチャを定義するために使用されます。デフォルト値で設定をインスタンス化すると、[PaddlePaddle/Not_yet_released](https://huggingface.co/PaddlePaddle/Not_yet_released) と同様の設定が得られます。 設定オブジェクトは [PreTrainedConfig](/docs/transformers/main/ja/main_classes/configuration#transformers.PreTrainedConfig) を継承し、モデルの出力を制御するために使用できます。詳細については、[PreTrainedConfig](/docs/transformers/main/ja/main_classes/configuration#transformers.PreTrainedConfig) のドキュメントを参照してください。 ## PPLCNetV4Backbone[[transformers.PPLCNetV4Backbone]] #### transformers.PPLCNetV4Backbone[[transformers.PPLCNetV4Backbone]] ```python transformers.PPLCNetV4Backbone(config: PPLCNetV4Config) ``` [ソース](https://github.com/huggingface/transformers/blob/main/src/transformers/models/pp_lcnet_v4/modeling_pp_lcnet_v4.py#L351) **パラメータ:** config ([PPLCNetV4Config](/docs/transformers/main/ja/model_doc/pp_lcnet_v4#transformers.PPLCNetV4Config)) : モデルのパラメータをすべて含むモデル設定クラスです。設定ファイルで初期化しても、モデルに関連する重みは読み込まれず、設定のみが読み込まれます。モデルの重みをロードするには、[from_pretrained()](/docs/transformers/main/ja/main_classes/model#transformers.PreTrainedModel.from_pretrained) メソッドを確認してください。 特徴量抽出用のPPLCNetV4バックボーンモデル。 このモデルは [PreTrainedModel](/docs/transformers/main/ja/main_classes/model#transformers.PreTrainedModel) を継承しています。ライブラリがすべてのモデルに対して実装している汎用的なメソッド（ダウンロードや保存、入力埋め込みのリサイズ、ヘッドのプルーニングなど）については、スーパークラスのドキュメントを参照してください。 このモデルは、PyTorchの[torch.nn.Module](https://pytorch.org/docs/stable/nn.html#torch.nn.Module)のサブクラスでもあります。通常のPyTorch Moduleとして使用し、一般的な使用方法や動作に関する詳細については、PyTorchのドキュメントを参照してください。 #### forward[[transformers.PPLCNetV4Backbone.forward]] ```python forward(pixel_values: Tensor, **kwargs: *) ``` [ソース](https://github.com/huggingface/transformers/blob/main/src/transformers/models/pp_lcnet_v4/modeling_pp_lcnet_v4.py#L364) **パラメータ:** pixel_values (`torch.Tensor`、shape `(batch_size, num_channels, image_size, image_size)`) : 入力画像に対応するテンソルです。ピクセル値は `image_processor_class` を使用して取得できます。詳細は `image_processor_class.__call__` を参照してください（`processor_class` は画像の処理に `image_processor_class` を使用します）。 **戻り値:** `BackboneOutput` または `tuple(torch.FloatTensor)` `BackboneOutput`または`torch.FloatTensor`のタプル（`return_dict=False`が渡された場合、または`config.return_dict=False`の場合）。[PPLCNetV4Config](/docs/transformers/main/ja/model_doc/pp_lcnet_v4#transformers.PPLCNetV4Config)および入力に応じて、さまざまな要素で構成されます。 [PPLCNetV4Backbone](/docs/transformers/main/ja/model_doc/pp_lcnet_v4#transformers.PPLCNetV4Backbone)のforwardメソッドは、`__call__`特殊メソッドをオーバーライドします。 この関数内でフォワードパスの手順を定義する必要がありますが、その後、この関数ではなく`Module`インスタンスを呼び出すべきです。前者は前処理と後処理の実行を適切に処理するのに対し、後者はそれらを無視してしまいます。 - **feature_maps** (`tuple(torch.FloatTensor)`、形状 `(batch_size, num_channels, height, width)`) -- 各ステージのフィーチャマップ。 - **hidden_states** (`tuple(torch.FloatTensor)`、*optional*、`output_hidden_states=True` が渡された場合または `config.output_hidden_states=True` の場合に返されます) -- `torch.FloatTensor` のタプル（埋め込みの出力用 1 つ + 各層の出力用 1 つ）。形状はバックボーンによって `(batch_size, sequence_length, hidden_size)` または `(batch_size, num_channels, height, width)` になります。 各ステージの出力におけるモデルのHidden-states、および初期の埋め込み出力。 - **attentions** (`tuple(torch.FloatTensor)`、*optional*、`output_attentions=True` が渡された場合または `config.output_attentions=True` の場合に返される) -- `torch.FloatTensor` のタプル（レイヤーごとに1つ）、形状は `(batch_size, num_heads, sequence_length, sequence_length)`。バックボーンがアテンションを使用する場合にのみ適用されます。 アテンションのsoftmax後のアテンション重み。自己アテンションヘッド内で加重平均を計算するために使用されます。 例: ```python >>> from transformers import PPLCNetV4Config, PPLCNetV4Backbone >>> import torch >>> config = PPLCNetV4Config() >>> model = PPLCNetV4Backbone(config) >>> pixel_values = torch.randn(1, 3, 224, 224) >>> with torch.no_grad(): ... outputs = model(pixel_values) >>> feature_maps = outputs.feature_maps >>> list(feature_maps[-1].shape) ```