Transformers documentation
Hiera
Mô hình này được công bố trên HF papers vào ngày 2023-06-01 và được đóng góp cho Hugging Face Transformers vào ngày 2024-07-12.
Hiera
Tổng quan
Hiera được đề xuất trong Hiera: A Hierarchical Vision Transformer without the Bells-and-Whistles bởi Chaitanya Ryali, Yuan-Ting Hu, Daniel Bolya, Chen Wei, Haoqi Fan, Po-Yao Huang, Vaibhav Aggarwal, Arkabandhu Chowdhury, Omid Poursaeed, Judy Hoffman, Jitendra Malik, Yanghao Li, Christoph Feichtenhofer
Bài báo giới thiệu “Hiera,” một Vision Transformer phân cấp đơn giản hóa kiến trúc của các vision transformer phân cấp hiện đại bằng cách loại bỏ các thành phần không cần thiết mà không làm giảm độ chính xác hay hiệu suất. Khác với các transformer truyền thống thêm các thành phần đặc thù cho thị giác phức tạp để cải thiện hiệu suất phân loại có giám sát, Hiera cho thấy các bổ sung này, thường được gọi là “bells-and-whistles,” không phải là yếu tố thiết yếu để đạt độ chính xác cao. Bằng cách tận dụng một tác vụ tiền xử lý thị giác mạnh (MAE) cho quá trình huấn luyện trước, Hiera giữ được sự đơn giản và đạt được độ chính xác cũng như tốc độ vượt trội cả trong suy luận lẫn huấn luyện trên nhiều tác vụ nhận dạng ảnh và video. Phương pháp này gợi ý rằng các thiên kiến không gian cần thiết cho các tác vụ thị giác có thể được học một cách hiệu quả thông qua huấn luyện trước phù hợp, loại bỏ nhu cầu về độ phức tạp kiến trúc bổ sung.
Tóm tắt từ bài báo như sau:
Các transformer thị giác phân cấp hiện đại đã bổ sung một số thành phần đặc thù cho thị giác nhằm theo đuổi hiệu suất phân loại có giám sát. Mặc dù các thành phần này mang lại độ chính xác hiệu quả và số lượng FLOP hấp dẫn, nhưng độ phức tạp bổ sung thực sự khiến các transformer này chậm hơn so với các phiên bản ViT thông thường. Trong bài báo này, chúng tôi lập luận rằng phần cồng kềnh bổ sung này là không cần thiết. Bằng cách tiền huấn luyện với một nhiệm vụ tiền đề thị giác mạnh (MAE), chúng tôi có thể loại bỏ tất cả các tính năng rườm rà khỏi một transformer thị giác đa giai đoạn tiên tiến mà không làm mất độ chính xác. Trong quá trình đó, chúng tôi tạo ra Hiera, một transformer thị giác phân cấp cực kỳ đơn giản, chính xác hơn các mô hình trước đó đồng thời nhanh hơn đáng kể cả ở giai đoạn suy luận lẫn trong quá trình huấn luyện. Chúng tôi đánh giá Hiera trên nhiều nhiệm vụ nhận dạng hình ảnh và video. Mã nguồn và mô hình của chúng tôi có sẵn tại https://github.com/facebookresearch/hiera.
Hiera architecture. Taken from the original paper. Mô hình này là đóng góp chung của EduardoPacheco và namangarg110. Mã nguồn gốc có thể được tìm thấy [tại đây] (https://github.com/facebookresearch/hiera).
Tài nguyên
Danh sách các tài nguyên chính thức của Hugging Face và cộng đồng (được đánh dấu bằng 🌎) để giúp bạn bắt đầu với Hiera. Nếu bạn quan tâm đến việc gửi tài nguyên để được đưa vào đây, hãy thoải mái mở một Pull Request và chúng tôi sẽ xem xét! Lý tưởng nhất là tài nguyên nên minh họa một điều gì đó mới thay vì sao chép một tài nguyên hiện có.
- HieraForImageClassification được hỗ trợ bởi notebook này.
- Xem thêm: Hướng dẫn tác vụ phân loại hình ảnh
HieraConfig
lớp transformers.HieraConfig
< source >( transformers_version: str | None = Nonearchitectures: list[str] | None = Noneoutput_hidden_states: bool | None = Falsereturn_dict: bool | None = Truedtype: str | torch.dtype | None = Nonechunk_size_feed_forward: int = 0is_encoder_decoder: bool = Falseid2label: dict[int, str] | dict[str, str] | None = Nonelabel2id: dict[str, int] | dict[str, str] | None = Noneproblem_type: Literal['regression', 'single_label_classification', 'multi_label_classification'] | None = Noneembed_dim: int = 96image_size: list[int] | tuple[int, ...] = (224, 224)patch_size: list[int] | tuple[int, ...] = (7, 7)patch_stride: list[int] | tuple[int, ...] = (4, 4)patch_padding: list[int] | tuple[int, ...] = (3, 3)mlp_ratio: float = 4.0depths: list[int] | tuple[int, ...] = (2, 3, 16, 3)num_heads: list[int] | tuple[int, ...] = (1, 2, 4, 8)embed_dim_multiplier: float | int = 2.0num_query_pool: int = 3query_stride: list[int] | tuple[int, ...] = (2, 2)masked_unit_size: list[int] | tuple[int, ...] = (8, 8)masked_unit_attention: list[bool] | tuple[bool, ...] = (True, True, False, False)drop_path_rate: float | int = 0.0num_channels: int = 3hidden_act: str = 'gelu'initializer_range: float = 0.02layer_norm_init: float = 1.0layer_norm_eps: float = 1e-06decoder_hidden_size: int | None = Nonedecoder_depth: int | None = Nonedecoder_num_heads: int | None = Nonenormalize_pixel_loss: bool | None = Truemask_ratio: float = 0.6_out_features: list[str] | None = None_out_indices: list[int] | None = None )
Tham số
- embed_dim (
int, tùy chọn, mặc định là96) — Kích thước của các embedding và trạng thái ẩn. - image_size (
Union[list[int], tuple[int, ...]], tùy chọn, mặc định là(224, 224)) — Kích thước (độ phân giải) của mỗi hình ảnh. - patch_size (
Union[list[int], tuple[int, ...]], tùy chọn, mặc định là(7, 7)) — Kích thước (độ phân giải) của mỗi patch. - patch_stride (
list(int), tùy chọn, mặc định là[4, 4]) — Bước nhảy (stride) của patch. - patch_padding (
list(int), tùy chọn, mặc định là[3, 3]) — Độ đệm của patch. - mlp_ratio (
float, tùy chọn, mặc định là4.0) — Tỷ lệ giữa chiều ẩn của MLP và chiều nhúng. - depths (
Union[list[int], tuple[int, ...]], tùy chọn, mặc định là(2, 3, 16, 3)) — Độ sâu của từng lớp trong Transformer. - num_heads (
list(int), tùy chọn, mặc định là[1, 2, 4, 8]) — Số lượng đầu chú ý (attention heads) trong mỗi lớp của bộ mã hóa Transformer. - embed_dim_multiplier (
float, tùy chọn, mặc định là 2.0) — Hệ số nhân cho chiều của patch embedding trong mỗi lớp của bộ mã hóa Transformer. - num_query_pool (
int, tùy chọn, mặc định là 3) — Số lượng giai đoạn query pool. - query_stride (
list(int), tùy chọn, mặc định là[2, 2]) — Bước nhảy (stride) của query pool. - masked_unit_size (
list(int), tùy chọn, mặc định là[8, 8]) — Kích thước của đơn vị bị che. - masked_unit_attention (
list(bool), tùy chọn, mặc định là[True, True, False, False]) — Xác định có sử dụng masked unit attention trong từng lớp của bộ mã hóa Transformer hay không. - drop_path_rate (
Union[float, int], tùy chọn, mặc định là0.0) — Tỷ lệ drop path cho việc hợp nhất patch. - num_channels (
int, tùy chọn, mặc định là3) — Số lượng kênh đầu vào. - hidden_act (
str, tùy chọn, mặc định làgelu) — Hàm kích hoạt phi tuyến (hàm hoặc chuỗi) trong bộ giải mã. Ví dụ,"gelu","relu","silu", v.v. - initializer_range (
float, tùy chọn, mặc định là0.02) — Độ lệch chuẩn của truncated_normal_initializer để khởi tạo tất cả các ma trận trọng số. - layer_norm_init (
float, tùy chọn, mặc định là 1.0) — Giá trị trọng số ban đầu cho các lớp chuẩn hóa lớp (layer normalization). - layer_norm_eps (
float, tùy chọn, mặc định là1e-06) — Giá trị epsilon được sử dụng bởi các lớp chuẩn hóa lớp (layer normalization). - decoder_hidden_size (
int, tùy chọn) — Kích thước của các biểu diễn ẩn. - decoder_depth (
int, tùy chọn) — Độ sâu của bộ giải mã cho huấn luyện trước MAE. - decoder_num_heads (
int, tùy chọn) — Số lượng đầu chú ý cho mỗi lớp chú ý trong bộ giải mã Transformer. - normalize_pixel_loss (
bool, tùy chọn, mặc định làTrue) — Có nên chuẩn hóa pixel loss theo số lượng pixel hay không. - mask_ratio (
float, tùy chọn, mặc định là 0.6) — Tỷ lệ các token bị che trong đầu vào.
Đây là lớp cấu hình để lưu trữ cấu hình của một HieraModel. Nó được sử dụng để khởi tạo một mô hình Hiera theo các đối số được chỉ định, xác định kiến trúc của mô hình. Khởi tạo một cấu hình với các giá trị mặc định sẽ tạo ra một cấu hình tương tự như cấu hình của facebook/hiera-base-224
Các đối tượng cấu hình kế thừa từ PreTrainedConfig và có thể được sử dụng để kiểm soát đầu ra của mô hình. Đọc tài liệu từ PreTrainedConfig để biết thêm thông tin.
Ví dụ:
>>> from transformers import HieraConfig, HieraModel
>>> # Initializing a Hiera hiera-base-patch16-224 style configuration
>>> configuration = HieraConfig()
>>> # Initializing a model (with random weights) from the hiera-base-patch16-224 style configuration
>>> model = HieraModel(configuration)
>>> # Accessing the model configuration
>>> configuration = model.configHieraModel
lớp transformers.HieraModel
< source >( config: HieraConfigadd_pooling_layer: bool = Trueis_mae: bool = False )
Tham số
- config (HieraConfig) — Lớp cấu hình mô hình chứa tất cả các tham số của mô hình. Khởi tạo bằng tệp cấu hình không tải trọng số liên quan đến mô hình, chỉ tải cấu hình. Xem phương thức from_pretrained() để tải trọng số của mô hình.
- add_pooling_layer (
bool, tùy chọn, mặc định làTrue) — Có áp dụng lớp pooling hay không. - is_mae (
bool, tùy chọn, mặc định làFalse) — Có chạy mô hình ở chế độ MAE hay không.
Mô hình Hiera thuần túy, xuất ra các hidden-state thô mà không có bất kỳ head cụ thể nào ở phía trên.
Mô hình này kế thừa từ PreTrainedModel. Xem tài liệu của lớp cha để biết các phương thức chung mà thư viện triển khai cho tất cả các mô hình của nó (chẳng hạn như tải xuống hoặc lưu trữ, thay đổi kích thước các nhúng đầu vào, cắt tỉa các đầu, v.v.)
Mô hình này cũng là một lớp con của torch.nn.Module trong PyTorch. Hãy sử dụng nó như một Module PyTorch thông thường và tham khảo tài liệu PyTorch cho mọi vấn đề liên quan đến cách sử dụng và hành vi chung.
forward
< source >( pixel_values: typing.Optional[torch.Tensor] = Nonenoise: typing.Optional[torch.Tensor] = Noneoutput_attentions: bool | None = Noneoutput_hidden_states: bool | None = Noneinterpolate_pos_encoding: bool | None = Nonereturn_dict: bool | None = None**kwargs ) → BaseModelOutputWithPooling or tuple(torch.Tensor)
Tham số
- pixel_values (
torch.Tensorcó hình dạng(batch_size, num_channels, image_size, image_size), tùy chọn) — Các tensor tương ứng với các hình ảnh đầu vào. Giá trị pixel có thể được lấy bằng cách sử dụng BitImageProcessor. Xem BitImageProcessor.call() để biết chi tiết (processor_classsử dụng BitImageProcessor để xử lý hình ảnh). - noise (
torch.Tensorcó hình dạng(batch_size, num_mask_units), tùy chọn) — Chủ yếu được sử dụng cho mục đích kiểm thử để kiểm soát tính ngẫu nhiên và duy trì khả năng tái lập - output_attentions (
bool, tùy chọn) — Có trả về các tensor attentions của tất cả các lớp attention hay không. Xemattentionstrong phần tensor được trả về để biết thêm chi tiết. - output_hidden_states (
bool, tùy chọn) — Có trả về trạng thái ẩn (hidden states) của tất cả các lớp hay không. Xemhidden_statestrong phần tensor trả về để biết thêm chi tiết. - interpolate_pos_encoding (
bool, tùy chọn) — Có nội suy các mã vị trí được huấn luyện trước hay không. - return_dict (
bool, tùy chọn) — Có nên trả về một ModelOutput thay vì một tuple thông thường hay không.
Trả về
BaseModelOutputWithPooling hoặc tuple(torch.Tensor)
Một BaseModelOutputWithPooling hoặc một tuple của
torch.Tensor (nếu return_dict=False được truyền hoặc khi config.return_dict=False) bao gồm các
thành phần khác nhau tùy thuộc vào cấu hình (HieraConfig) và đầu vào.
Phương thức forward của HieraModel ghi đè lên phương thức đặc biệt __call__.
Mặc dù công thức cho bước truyền tiến cần được định nghĩa bên trong hàm này, người dùng nên gọi instance của
Modulesau đó thay vì gọi hàm này, vì instanceModulesẽ đảm nhận việc thực hiện các bước tiền xử lý và hậu xử lý, trong khi hàm này sẽ lặng lẽ bỏ qua chúng.
last_hidden_state (
torch.Tensorcó hình dạng(batch_size, sequence_length, hidden_size)) — Chuỗi các hidden-state tại đầu ra của lớp cuối cùng của mô hình.pooler_output (
torch.Tensorcó hình dạng(batch_size, hidden_size)) — Trạng thái ẩn của lớp cuối cùng của token đầu tiên trong chuỗi (token phân loại) sau khi được xử lý thêm qua các lớp được sử dụng cho tác vụ tiền huấn luyện bổ trợ. Ví dụ, đối với các mô hình thuộc họ BERT, giá trị này trả về token phân loại sau khi được xử lý qua một lớp tuyến tính và một hàm kích hoạt tanh. Trọng số của lớp tuyến tính được huấn luyện từ mục tiêu dự đoán câu tiếp theo (phân loại) trong quá trình tiền huấn luyện.hidden_states (
tuple(torch.Tensor), tuỳ chọn, được trả về khioutput_hidden_states=Trueđược truyền vào hoặc khiconfig.output_hidden_states=True) — Bộ tuple củatorch.Tensor(một cho đầu ra của embeddings, nếu mô hình có lớp embedding, + một cho đầu ra của mỗi lớp) có hình dạng(batch_size, sequence_length, hidden_size).Trạng thái ẩn của mô hình tại đầu ra của mỗi lớp cùng với các đầu ra embedding ban đầu tùy chọn.
attentions (
tuple(torch.Tensor), tuỳ chọn, được trả về khioutput_attentions=Trueđược truyền vào hoặc khiconfig.output_attentions=True) — Tuple củatorch.Tensor(một cho mỗi lớp) có hình dạng(batch_size, num_heads, sequence_length, sequence_length).Trọng số chú ý sau softmax của attention, được sử dụng để tính trung bình có trọng số trong các đầu self-attention.
HieraForPreTraining
lớp transformers.HieraForPreTraining
< source >( config: HieraConfig )
Tham số
- config (HieraConfig) — Lớp cấu hình mô hình chứa tất cả các tham số của mô hình. Khởi tạo bằng tệp cấu hình không tải trọng số liên quan đến mô hình, chỉ tải cấu hình. Xem phương thức from_pretrained() để tải trọng số của mô hình.
Transformer của Mô hình Hiera với bộ giải mã phía trên cho tiền huấn luyện tự giám sát.
Mô hình này kế thừa từ PreTrainedModel. Xem tài liệu của lớp cha để biết các phương thức chung mà thư viện triển khai cho tất cả các mô hình của nó (chẳng hạn như tải xuống hoặc lưu trữ, thay đổi kích thước các nhúng đầu vào, cắt tỉa các đầu, v.v.)
Mô hình này cũng là một lớp con của torch.nn.Module trong PyTorch. Hãy sử dụng nó như một Module PyTorch thông thường và tham khảo tài liệu PyTorch cho mọi vấn đề liên quan đến cách sử dụng và hành vi chung.
forward
< source >( pixel_values: typing.Optional[torch.Tensor] = Nonenoise: typing.Optional[torch.Tensor] = Noneoutput_attentions: bool | None = Noneoutput_hidden_states: bool | None = Noneinterpolate_pos_encoding: bool | None = Nonereturn_dict: bool | None = None**kwargs ) → HieraForPreTrainingOutput or tuple(torch.Tensor)
Tham số
- pixel_values (
torch.Tensorcó hình dạng(batch_size, num_channels, image_size, image_size), tùy chọn) — Các tensor tương ứng với các hình ảnh đầu vào. Giá trị pixel có thể được lấy bằng cách sử dụng BitImageProcessor. Xem BitImageProcessor.call() để biết chi tiết (processor_classsử dụng BitImageProcessor để xử lý hình ảnh). - noise (
torch.Tensorcó hình dạng(batch_size, num_mask_units), tùy chọn) — Chủ yếu được sử dụng cho mục đích kiểm thử để kiểm soát tính ngẫu nhiên và duy trì khả năng tái lập - output_attentions (
bool, tùy chọn) — Có trả về các tensor attentions của tất cả các lớp attention hay không. Xemattentionstrong phần tensor được trả về để biết thêm chi tiết. - output_hidden_states (
bool, tùy chọn) — Có trả về trạng thái ẩn (hidden states) của tất cả các lớp hay không. Xemhidden_statestrong phần tensor trả về để biết thêm chi tiết. - interpolate_pos_encoding (
bool, tùy chọn) — Có nội suy các mã vị trí được huấn luyện trước hay không. - return_dict (
bool, tùy chọn) — Có nên trả về một ModelOutput thay vì một tuple thông thường hay không.
Trả về
HieraForPreTrainingOutput hoặc tuple(torch.Tensor)
Một HieraForPreTrainingOutput hoặc một tuple của
torch.Tensor (nếu return_dict=False được truyền hoặc khi config.return_dict=False) bao gồm các
thành phần khác nhau tùy thuộc vào cấu hình (HieraConfig) và đầu vào.
Phương thức forward của HieraForPreTraining ghi đè lên phương thức đặc biệt __call__.
Mặc dù công thức cho bước truyền tiến cần được định nghĩa bên trong hàm này, người dùng nên gọi instance của
Modulesau đó thay vì gọi hàm này, vì instanceModulesẽ đảm nhận việc thực hiện các bước tiền xử lý và hậu xử lý, trong khi hàm này sẽ lặng lẽ bỏ qua chúng.
loss (
torch.Tensorcó hình dạng(1,)) — Tổn tái tạo pixel.logits (
torch.Tensorcó hình dạng(batch_size, sequence_length, patch_size ** 2 * num_channels)) — Logits tái tạo pixel.bool_masked_pos (
torch.BoolTensorcó hình dạng(batch_size, sequence_length)) — Tensor chỉ ra các patch bị che (0) và không bị che (1).ids_restore (
torch.LongTensorcó hình dạng(batch_size, sequence_length)) — Tensor chứa chỉ số gốc của các patch (đã xáo trộn) bị che.hidden_states (
tuple[torch.Tensor], tuỳ chọn, được trả về khioutput_hidden_states=Trueđược truyền vào hoặc khiconfig.output_hidden_states=True) — Tuple củatorch.Tensor(một cho đầu ra của embeddings, nếu mô hình có lớp embedding, + một cho đầu ra của mỗi lớp) có hình dạng(batch_size, sequence_length, hidden_size).Trạng thái ẩn của mô hình tại đầu ra của mỗi lớp cùng với các đầu ra embedding ban đầu tùy chọn.
attentions (
tuple[torch.Tensor], tuỳ chọn, được trả về khioutput_attentions=Trueđược truyền vào hoặc khiconfig.output_attentions=True) — Tuple củatorch.Tensor(một cho mỗi lớp) có hình dạng(batch_size, num_heads, sequence_length, sequence_length).Trọng số chú ý sau softmax của attention, được sử dụng để tính trung bình có trọng số trong các đầu self-attention.
reshaped_hidden_states (
tuple(torch.Tensor), tuỳ chọn, được trả về khioutput_hidden_states=Trueđược truyền vào hoặc khiconfig.output_hidden_states=True) — Tuple củatorch.Tensor(một cho đầu ra của embeddings + một cho đầu ra của mỗi lớp) có shape(batch_size, height, width, hidden_size). Hidden-states của mô hình tại đầu ra của mỗi lớp cùng với đầu ra embedding ban đầu được định hình lại để bao gồm các chiều không gian.
Ví dụ:
>>> from transformers import AutoImageProcessor, HieraForPreTraining
>>> import torch
>>> from PIL import Image
>>> from huggingface_hub.utils import httpx
>>> from io import BytesIO
>>> url = "http://images.cocodataset.org/val2017/000000039769.jpg"
>>> with httpx.stream("GET", url) as response:
... image = Image.open(BytesIO(response.read()))
>>> image_processor = AutoImageProcessor.from_pretrained("facebook/hiera-tiny-224-mae-hf")
>>> model = HieraForPreTraining.from_pretrained("facebook/hiera-tiny-224-mae-hf")
>>> inputs = image_processor(images=image, return_tensors="pt")
>>> outputs = model(**inputs)
>>> logits = outputs.logits
>>> loss = outputs.loss
>>> print(list(logits.shape))
[1, 196, 768]HieraForImageClassification
lớp transformers.HieraForImageClassification
< source >( config: HieraConfig )
Tham số
- config (HieraConfig) — Lớp cấu hình mô hình chứa tất cả các tham số của mô hình. Khởi tạo bằng tệp cấu hình không tải trọng số liên quan đến mô hình, chỉ tải cấu hình. Xem phương thức from_pretrained() để tải trọng số của mô hình.
Model transformer Hiera với đầu phân loại hình ảnh phía trên (một lớp tuyến tính phía trên trạng thái ẩn cuối cùng với pooling trung bình) ví dụ cho ImageNet.
Lưu ý rằng có thể tinh chỉnh Hiera trên các hình ảnh có độ phân giải cao hơn so với những hình ảnh mà nó đã được huấn luyện, bằng cách đặt
interpolate_pos_encodingthànhTruetrong forward của mô hình. Thao tác này sẽ nội suy các position embeddings đã được huấn luyện trước lên độ phân giải cao hơn.
Mô hình này kế thừa từ PreTrainedModel. Xem tài liệu của lớp cha để biết các phương thức chung mà thư viện triển khai cho tất cả các mô hình của nó (chẳng hạn như tải xuống hoặc lưu trữ, thay đổi kích thước các nhúng đầu vào, cắt tỉa các đầu, v.v.)
Mô hình này cũng là một lớp con của torch.nn.Module trong PyTorch. Hãy sử dụng nó như một Module PyTorch thông thường và tham khảo tài liệu PyTorch cho mọi vấn đề liên quan đến cách sử dụng và hành vi chung.
forward
< source >( pixel_valueslabels: typing.Optional[torch.Tensor] = Noneoutput_attentions: bool | None = Noneoutput_hidden_states: bool | None = Noneinterpolate_pos_encoding: bool | None = Nonereturn_dict: bool | None = None**kwargs ) → HieraForImageClassificationOutput or tuple(torch.Tensor)
Tham số
- pixel_values (`
of shape(batch_size, num_channels, image_size, image_size)) -- The tensors corresponding to the input images. Pixel values can be obtained using [BitImageProcessor](/docs/transformers/main/en/model_doc/bit#transformers.BitImageProcessor). See [BitImageProcessor.__call__()](/docs/transformers/main/en/model_doc/molmo2#transformers.Molmo2ImageProcessor.__call__) for details (processor_class` uses BitImageProcessor for processing images). - labels (
torch.LongTensorcó shape(batch_size,), tùy chọn) — Nhãn để tính loss phân loại/hồi quy ảnh. Các chỉ số phải nằm trong[0, ..., config.num_labels - 1]. Nếuconfig.num_labels == 1, loss hồi quy sẽ được tính (Mean-Square loss). Nếuconfig.num_labels > 1, loss phân loại sẽ được tính (Cross-Entropy). - output_attentions (
bool, tùy chọn) — Có trả về các tensor attentions của tất cả các lớp attention hay không. Xemattentionstrong phần tensor được trả về để biết thêm chi tiết. - output_hidden_states (
bool, tùy chọn) — Có trả về trạng thái ẩn (hidden states) của tất cả các lớp hay không. Xemhidden_statestrong phần tensor trả về để biết thêm chi tiết. - interpolate_pos_encoding (
bool, tùy chọn) — Có nội suy các mã vị trí được huấn luyện trước hay không. - return_dict (
bool, tùy chọn) — Có nên trả về một ModelOutput thay vì một tuple thông thường hay không.
Trả về
HieraForImageClassificationOutput hoặc tuple(torch.Tensor)
Một HieraForImageClassificationOutput hoặc một tuple của
torch.Tensor (nếu return_dict=False được truyền hoặc khi config.return_dict=False) bao gồm các
thành phần khác nhau tùy thuộc vào cấu hình (HieraConfig) và đầu vào.
Phương thức forward của HieraForImageClassification ghi đè lên phương thức đặc biệt __call__.
Mặc dù công thức cho bước truyền tiến cần được định nghĩa bên trong hàm này, người dùng nên gọi instance của
Modulesau đó thay vì gọi hàm này, vì instanceModulesẽ đảm nhận việc thực hiện các bước tiền xử lý và hậu xử lý, trong khi hàm này sẽ lặng lẽ bỏ qua chúng.
loss (
torch.Tensorcó shape(1,), optional, được trả về khilabelsđược cung cấp) — Loss phân loại (hoặc hồi quy nếu config.num_labels==1).logits (
torch.Tensorcó hình dạng(batch_size, config.num_labels)) — Điểm phân loại (hoặc hồi quy nếu config.num_labels==1) (trước SoftMax).hidden_states (
tuple(torch.Tensor), tuỳ chọn, được trả về khioutput_hidden_states=Trueđược truyền vào hoặc khiconfig.output_hidden_states=True) — Tuple củatorch.Tensor(một cho đầu ra của embeddings, nếu mô hình có lớp embedding, + một cho đầu ra của mỗi giai đoạn) có hình dạng(batch_size, sequence_length, hidden_size). Hidden-states (còn được gọi là feature maps) của mô hình tại đầu ra của mỗi giai đoạn.attentions (
tuple(torch.Tensor), tuỳ chọn, được trả về khioutput_attentions=Trueđược truyền vào hoặc khiconfig.output_attentions=True) — Tuple củatorch.Tensor(một cho mỗi lớp) có hình dạng(batch_size, num_heads, patch_size, sequence_length).Trọng số chú ý sau softmax của attention, được sử dụng để tính trung bình có trọng số trong các đầu self-attention.
reshaped_hidden_states (
tuple(torch.Tensor),optional) — Tuple củatorch.Tensor(một cho đầu ra của embeddings + một cho đầu ra của mỗi stage) có shape(batch_size, height, width, hidden_size). Đây là các hidden states đã được reshape và re-roll của model.Trạng thái ẩn (hidden-states) của mô hình tại đầu ra của mỗi lớp cùng với đầu ra của lớp nhúng (embedding) ban đầu, được định dạng lại (reshape) để bao gồm các chiều không gian.
Ví dụ:
>>> from transformers import AutoImageProcessor, HieraForImageClassification
>>> import torch
>>> from datasets import load_dataset
>>> dataset = load_dataset("huggingface/cats-image")
>>> image = dataset["test"]["image"][0]
>>> image_processor = AutoImageProcessor.from_pretrained("facebook/hiera-base-224")
>>> model = HieraForImageClassification.from_pretrained("facebook/hiera-base-224")
>>> inputs = image_processor(image, return_tensors="pt")
>>> with torch.no_grad():
... logits = model(**inputs).logits
>>> # model predicts one of the 1000 ImageNet classes
>>> predicted_label = logits.argmax(-1).item()
>>> print(model.config.id2label[predicted_label])
...