<codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">get_device</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span>→ str<aclass="headerlink"href="#onnxruntime.get_device"title="Permalink to this definition">¶</a></dt>
<dd><p>Return the device used to compute the prediction (CPU, MKL, …)</p>
</dd></dl>
</div>
<divclass="section"id="examples-and-datasets">
<h2><aclass="toc-backref"href="#id2">Examples and datasets</a><aclass="headerlink"href="#examples-and-datasets"title="Permalink to this headline">¶</a></h2>
<p>The package contains a few models stored in ONNX format
used in the documentation. These don’t need to be downloaded
<codeclass="sig-prename descclassname">onnxruntime.datasets.</code><codeclass="sig-name descname">get_example</code><spanclass="sig-paren">(</span><emclass="sig-param">name</em><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/datasets.html#get_example"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.datasets.get_example"title="Permalink to this definition">¶</a></dt>
<dd><p>Retrieves the absolute file name of an example.</p>
</dd></dl>
</div>
<divclass="section"id="load-and-run-a-model">
<h2><aclass="toc-backref"href="#id3">Load and run a model</a><aclass="headerlink"href="#load-and-run-a-model"title="Permalink to this headline">¶</a></h2>
<p><em>ONNX Runtime</em> reads a model saved in ONNX format.
The main class <em>InferenceSession</em> wraps these functionalities
<emclass="property">class </em><codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">ModelMetadata</code><aclass="headerlink"href="#onnxruntime.ModelMetadata"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">custom_metadata_map</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.custom_metadata_map"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">description</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.description"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">domain</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.domain"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">graph_name</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.graph_name"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">producer_name</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.producer_name"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">version</code><aclass="headerlink"href="#onnxruntime.ModelMetadata.version"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">InferenceSession</code><spanclass="sig-paren">(</span><emclass="sig-param">path_or_bytes</em>, <emclass="sig-param">sess_options=None</em><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">disable_fallback</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.disable_fallback"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.disable_fallback"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">enable_fallback</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.enable_fallback"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.enable_fallback"title="Permalink to this definition">¶</a></dt>
<dd><p>Enable session.Run() fallback mechanism. If session.Run() fails due to an internal Execution Provider failure, reset the Execution Providers
enabled for this session.
If GPU is enabled, fall back to CUDAExecutionProvider.
<codeclass="sig-name descname">end_profiling</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.end_profiling"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.end_profiling"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_inputs</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.get_inputs"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.get_inputs"title="Permalink to this definition">¶</a></dt>
<dd><p>Return the inputs metadata as a list of <aclass="reference internal"href="#onnxruntime.NodeArg"title="onnxruntime.NodeArg"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">onnxruntime.NodeArg</span></code></a>.</p>
<codeclass="sig-name descname">get_modelmeta</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.get_modelmeta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.get_modelmeta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_outputs</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.get_outputs"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.get_outputs"title="Permalink to this definition">¶</a></dt>
<dd><p>Return the outputs metadata as a list of <aclass="reference internal"href="#onnxruntime.NodeArg"title="onnxruntime.NodeArg"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">onnxruntime.NodeArg</span></code></a>.</p>
<codeclass="sig-name descname">get_overridable_initializers</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.get_overridable_initializers"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.get_overridable_initializers"title="Permalink to this definition">¶</a></dt>
<dd><p>Return the inputs (including initializers) metadata as a list of <aclass="reference internal"href="#onnxruntime.NodeArg"title="onnxruntime.NodeArg"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">onnxruntime.NodeArg</span></code></a>.</p>
<codeclass="sig-name descname">get_providers</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.get_providers"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.get_providers"title="Permalink to this definition">¶</a></dt>
<dd><p>Return list of registered execution providers.</p>
<codeclass="sig-name descname">run</code><spanclass="sig-paren">(</span><emclass="sig-param">output_names</em>, <emclass="sig-param">input_feed</em>, <emclass="sig-param">run_options=None</em><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.run"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.run"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">set_providers</code><spanclass="sig-paren">(</span><emclass="sig-param">providers</em><spanclass="sig-paren">)</span><aclass="reference internal"href="_modules/onnxruntime/capi/session.html#InferenceSession.set_providers"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#onnxruntime.InferenceSession.set_providers"title="Permalink to this definition">¶</a></dt>
<dd><p>Register the input list of execution providers. The underlying session is re-created.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>providers</strong>– list of execution providers</p>
</dd>
</dl>
<p>The list of providers is ordered by Priority. For example [‘CUDAExecutionProvider’, ‘CPUExecutionProvider’] means
execute a node using CUDAExecutionProvider if capable, otherwise execute using CPUExecutionProvider.</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">NodeArg</code><aclass="headerlink"href="#onnxruntime.NodeArg"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">name</code><aclass="headerlink"href="#onnxruntime.NodeArg.name"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">shape</code><aclass="headerlink"href="#onnxruntime.NodeArg.shape"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">type</code><aclass="headerlink"href="#onnxruntime.NodeArg.type"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">RunOptions</code><aclass="headerlink"href="#onnxruntime.RunOptions"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">log_severity_level</code><aclass="headerlink"href="#onnxruntime.RunOptions.log_severity_level"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">log_verbosity_level</code><aclass="headerlink"href="#onnxruntime.RunOptions.log_verbosity_level"title="Permalink to this definition">¶</a></dt>
<dd><p>VLOG level if DEBUG build and run_log_severity_level is 0.
<emclass="property">property </em><codeclass="sig-name descname">logid</code><aclass="headerlink"href="#onnxruntime.RunOptions.logid"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">terminate</code><aclass="headerlink"href="#onnxruntime.RunOptions.terminate"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">onnxruntime.</code><codeclass="sig-name descname">SessionOptions</code><aclass="headerlink"href="#onnxruntime.SessionOptions"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">enable_cpu_mem_arena</code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_cpu_mem_arena"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">enable_mem_pattern</code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_mem_pattern"title="Permalink to this definition">¶</a></dt>
<dd><p>Enable the memory pattern optimization. Default is true.</p>
<emclass="property">property </em><codeclass="sig-name descname">enable_profiling</code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_profiling"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">execution_mode</code><aclass="headerlink"href="#onnxruntime.SessionOptions.execution_mode"title="Permalink to this definition">¶</a></dt>
<dd><p>Sets the execution mode. Default is sequential.</p>
<emclass="property">property </em><codeclass="sig-name descname">graph_optimization_level</code><aclass="headerlink"href="#onnxruntime.SessionOptions.graph_optimization_level"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">inter_op_num_threads</code><aclass="headerlink"href="#onnxruntime.SessionOptions.inter_op_num_threads"title="Permalink to this definition">¶</a></dt>
<dd><p>Sets the number of threads used to parallelize the execution of the graph (across nodes). Default is 0 to let onnxruntime choose.</p>
<emclass="property">property </em><codeclass="sig-name descname">intra_op_num_threads</code><aclass="headerlink"href="#onnxruntime.SessionOptions.intra_op_num_threads"title="Permalink to this definition">¶</a></dt>
<dd><p>Sets the number of threads used to parallelize the execution within nodes. Default is 0 to let onnxruntime choose.</p>
<emclass="property">property </em><codeclass="sig-name descname">log_severity_level</code><aclass="headerlink"href="#onnxruntime.SessionOptions.log_severity_level"title="Permalink to this definition">¶</a></dt>
<dd><p>Log severity level. Applies to session load, initialization, etc.
0:Verbose, 1:Info, 2:Warning. 3:Error, 4:Fatal. Default is 2.</p>
<emclass="property">property </em><codeclass="sig-name descname">log_verbosity_level</code><aclass="headerlink"href="#onnxruntime.SessionOptions.log_verbosity_level"title="Permalink to this definition">¶</a></dt>
<dd><p>VLOG level if DEBUG build and session_log_verbosity_level is 0.
Applies to session load, initialization, etc. Default is 0.</p>
<emclass="property">property </em><codeclass="sig-name descname">logid</code><aclass="headerlink"href="#onnxruntime.SessionOptions.logid"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">optimized_model_filepath</code><aclass="headerlink"href="#onnxruntime.SessionOptions.optimized_model_filepath"title="Permalink to this definition">¶</a></dt>
<dd><p>File path to serialize optimized model. By default, optimized model is not serialized if optimized_model_filepath is not provided.</p>
<codeclass="sig-prename descclassname">onnxruntime.backend.</code><codeclass="sig-name descname">is_compatible</code><spanclass="sig-paren">(</span><emclass="sig-param">model</em>, <emclass="sig-param">device=None</em>, <emclass="sig-param">**kwargs</em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.is_compatible"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">onnxruntime.backend.</code><codeclass="sig-name descname">prepare</code><spanclass="sig-paren">(</span><emclass="sig-param">model</em>, <emclass="sig-param">device=None</em>, <emclass="sig-param">**kwargs</em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.prepare"title="Permalink to this definition">¶</a></dt>
<dd><p>Load the model and creates a <aclass="reference internal"href="#onnxruntime.InferenceSession"title="onnxruntime.InferenceSession"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">onnxruntime.InferenceSession</span></code></a>
<codeclass="sig-prename descclassname">onnxruntime.backend.</code><codeclass="sig-name descname">run</code><spanclass="sig-paren">(</span><emclass="sig-param">model</em>, <emclass="sig-param">inputs</em>, <emclass="sig-param">device=None</em>, <emclass="sig-param">**kwargs</em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.run"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">onnxruntime.backend.</code><codeclass="sig-name descname">supports_device</code><spanclass="sig-paren">(</span><emclass="sig-param">device</em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.supports_device"title="Permalink to this definition">¶</a></dt>