Stay organized with collections
Save and categorize content based on your preferences.
tensorflow::ops::Restore
#include <io_ops.h>
Restores a tensor from checkpoint files.
Summary
Reads a tensor stored in one or several files. If there are several files (for instance because a tensor was saved as slices), file_pattern
may contain wildcard symbols (*
and ?
) in the filename portion only, not in the directory portion.
If a file_pattern
matches several files, preferred_shard
can be used to hint in which file the requested tensor is likely to be found. This op will first open the file at index preferred_shard
in the list of matching files and try to restore tensors from that file. Only if some tensors or tensor slices are not found in that first file, then the Op opens all the files. Setting preferred_shard
to match the value passed as the shard
input of a matching Save
Op may speed up Restore. This attribute only affects performance, not correctness. The default value -1 means files are processed in order.
See also RestoreSlice
.
Args:
- scope: A Scope object
- file_pattern: Must have a single element. The pattern of the files from which we read the tensor.
- tensor_name: Must have a single element. The name of the tensor to be restored.
- dt: The type of the tensor to be restored.
Optional attributes (see Attrs
):
- preferred_shard: Index of file to open first if multiple files match
file_pattern
.
Returns:
Public attributes
Public functions
node
::tensorflow::Node * node() const
operator::tensorflow::Input() const
operator::tensorflow::Output
operator::tensorflow::Output() const
Public static functions
PreferredShard
Attrs PreferredShard(
int64 x
)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Some content is licensed under the numpy license.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[],[],null,["# tensorflow::ops::Restore Class Reference\n\ntensorflow::ops::Restore\n========================\n\n`#include \u003cio_ops.h\u003e`\n\nRestores a tensor from checkpoint files.\n\nSummary\n-------\n\nReads a tensor stored in one or several files. If there are several files (for instance because a tensor was saved as slices), `file_pattern` may contain wildcard symbols (`*` and `?`) in the filename portion only, not in the directory portion.\n\nIf a `file_pattern` matches several files, `preferred_shard` can be used to hint in which file the requested tensor is likely to be found. This op will first open the file at index `preferred_shard` in the list of matching files and try to restore tensors from that file. Only if some tensors or tensor slices are not found in that first file, then the Op opens all the files. Setting `preferred_shard` to match the value passed as the `shard` input of a matching [Save](/versions/r2.14/api_docs/cc/class/tensorflow/ops/save#classtensorflow_1_1ops_1_1_save) Op may speed up [Restore](/versions/r2.14/api_docs/cc/class/tensorflow/ops/restore#classtensorflow_1_1ops_1_1_restore). This attribute only affects performance, not correctness. The default value -1 means files are processed in order.\n\nSee also [RestoreSlice](/versions/r2.14/api_docs/cc/class/tensorflow/ops/restore-slice#classtensorflow_1_1ops_1_1_restore_slice).\n\nArgs:\n\n- scope: A [Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope) object\n- file_pattern: Must have a single element. The pattern of the files from which we read the tensor.\n- tensor_name: Must have a single element. The name of the tensor to be restored.\n- dt: The type of the tensor to be restored.\n\n\u003cbr /\u003e\n\nOptional attributes (see [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/restore/attrs#structtensorflow_1_1ops_1_1_restore_1_1_attrs)):\n\n- preferred_shard: Index of file to open first if multiple files match `file_pattern`.\n\n\u003cbr /\u003e\n\nReturns:\n\n- [Output](/versions/r2.14/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output): The restored tensor.\n\n\u003cbr /\u003e\n\n| ### Constructors and Destructors ||\n|---|---|\n| [Restore](#classtensorflow_1_1ops_1_1_restore_1a06392cfeb62e5bbcd5a12c8c24f4a454)`(const ::`[tensorflow::Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` file_pattern, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` tensor_name, DataType dt)` ||\n| [Restore](#classtensorflow_1_1ops_1_1_restore_1a6bc04bd5b6925c42d2ab9fac0d053774)`(const ::`[tensorflow::Scope](/versions/r2.14/api_docs/cc/class/tensorflow/scope#classtensorflow_1_1_scope)` & scope, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` file_pattern, ::`[tensorflow::Input](/versions/r2.14/api_docs/cc/class/tensorflow/input#classtensorflow_1_1_input)` tensor_name, DataType dt, const `[Restore::Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/restore/attrs#structtensorflow_1_1ops_1_1_restore_1_1_attrs)` & attrs)` ||\n\n| ### Public attributes ||\n|-------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| [operation](#classtensorflow_1_1ops_1_1_restore_1a512f0dcb5d23dea3939e1086b78490c9) | [Operation](/versions/r2.14/api_docs/cc/class/tensorflow/operation#classtensorflow_1_1_operation) |\n| [tensor](#classtensorflow_1_1ops_1_1_restore_1a7d6ad76f209f846683849ffcf4e5b2f9) | `::`[tensorflow::Output](/versions/r2.14/api_docs/cc/class/tensorflow/output#classtensorflow_1_1_output) |\n\n| ### Public functions ||\n|-------------------------------------------------------------------------------------------------------------------|------------------------|\n| [node](#classtensorflow_1_1ops_1_1_restore_1a6b5a77883f915a4b7e800cbda2f6b18a)`() const ` | `::tensorflow::Node *` |\n| [operator::tensorflow::Input](#classtensorflow_1_1ops_1_1_restore_1a20bb2f66a51a1413dda2b18f7880983f)`() const ` | |\n| [operator::tensorflow::Output](#classtensorflow_1_1ops_1_1_restore_1ab93346099735ce634a6caa5d98b8785d)`() const ` | |\n\n| ### Public static functions ||\n|-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|\n| [PreferredShard](#classtensorflow_1_1ops_1_1_restore_1afca86c5066310bcef8e07db991a9df2f)`(int64 x)` | [Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/restore/attrs#structtensorflow_1_1ops_1_1_restore_1_1_attrs) |\n\n| ### Structs ||\n|----------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| [tensorflow::ops::Restore::Attrs](/versions/r2.14/api_docs/cc/struct/tensorflow/ops/restore/attrs) | Optional attribute setters for [Restore](/versions/r2.14/api_docs/cc/class/tensorflow/ops/restore#classtensorflow_1_1ops_1_1_restore). |\n\nPublic attributes\n-----------------\n\n### operation\n\n```text\nOperation operation\n``` \n\n### tensor\n\n```text\n::tensorflow::Output tensor\n``` \n\nPublic functions\n----------------\n\n### Restore\n\n```gdscript\n Restore(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input file_pattern,\n ::tensorflow::Input tensor_name,\n DataType dt\n)\n``` \n\n### Restore\n\n```gdscript\n Restore(\n const ::tensorflow::Scope & scope,\n ::tensorflow::Input file_pattern,\n ::tensorflow::Input tensor_name,\n DataType dt,\n const Restore::Attrs & attrs\n)\n``` \n\n### node\n\n```gdscript\n::tensorflow::Node * node() const \n``` \n\n### operator::tensorflow::Input\n\n```gdscript\n operator::tensorflow::Input() const \n``` \n\n### operator::tensorflow::Output\n\n```gdscript\n operator::tensorflow::Output() const \n``` \n\nPublic static functions\n-----------------------\n\n### PreferredShard\n\n```text\nAttrs PreferredShard(\n int64 x\n)\n```"]]