working with <em>OrtValue</em> (s) while inferencing a model if provided as part of the input feed.</p>
<p>Below is an example showing creation of an <em>OrtValue</em> from a Numpy array while placing its backing memory
on a CUDA device:</p>
<divclass="highlight-python notranslate"><divclass="highlight"><pre><span></span><spanclass="c1">#X is numpy array on cpu, create an OrtValue and place it on cuda device id = 0</span>
<spanclass="n">ortvalue</span><spanclass="o">.</span><spanclass="n">shape</span><spanclass="p">()</span><spanclass="c1"># shape of the numpy array X</span>
<spanclass="n">Y_ortvalue</span><spanclass="o">=</span><spanclass="n">onnxruntime</span><spanclass="o">.</span><spanclass="n">OrtValue</span><spanclass="o">.</span><spanclass="n">ortvalue_from_shape_and_type</span><spanclass="p">([</span><spanclass="mi">3</span><spanclass="p">,</span><spanclass="mi">2</span><spanclass="p">],</span><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">float32</span><spanclass="p">,</span><spanclass="s1">'cuda'</span><spanclass="p">,</span><spanclass="mi">0</span><spanclass="p">)</span><spanclass="c1"># Change the shape to the actual shape of the output being bound</span>
<spanclass="n">Y_ortvalue</span><spanclass="o">=</span><spanclass="n">onnxruntime</span><spanclass="o">.</span><spanclass="n">OrtValue</span><spanclass="o">.</span><spanclass="n">ortvalue_from_shape_and_type</span><spanclass="p">([</span><spanclass="mi">3</span><spanclass="p">,</span><spanclass="mi">2</span><spanclass="p">],</span><spanclass="n">np</span><spanclass="o">.</span><spanclass="n">float32</span><spanclass="p">,</span><spanclass="s1">'cuda'</span><spanclass="p">,</span><spanclass="mi">0</span><spanclass="p">)</span><spanclass="c1"># Change the shape to the actual shape of the output being bound</span>
<codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">get_device</span></code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span>→<aclass="reference external"href="https://docs.python.org/3/library/stdtypes.html#str"title="(in Python v3.9)"><spanclass="pre">str</span></a><aclass="headerlink"href="#onnxruntime.get_device"title="Permalink to this definition">¶</a></dt>
<h2><aclass="toc-backref"href="#id4">Examples and datasets</a><aclass="headerlink"href="#examples-and-datasets"title="Permalink to this headline">¶</a></h2>
<codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.datasets.</span></code><codeclass="sig-name descname"><spanclass="pre">get_example</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">name</span></span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="modules/onnxruntime/datasets.html#get_example"><spanclass="viewcode-link"><spanclass="pre">[source]</span></span></a><aclass="headerlink"href="#onnxruntime.datasets.get_example"title="Permalink to this definition">¶</a></dt>
<h2><aclass="toc-backref"href="#id5">Load and run a model</a><aclass="headerlink"href="#load-and-run-a-model"title="Permalink to this headline">¶</a></h2>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">ModelMetadata</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">custom_metadata_map</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.custom_metadata_map"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">description</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.description"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">domain</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.domain"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">graph_description</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.graph_description"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">graph_name</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.graph_name"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">producer_name</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.producer_name"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">version</span></code><aclass="headerlink"href="#onnxruntime.ModelMetadata.version"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">InferenceSession</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">path_or_bytes</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">sess_options</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">providers</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">provider_options</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="modules/onnxruntime/capi/onnxruntime_inference_collection.html#InferenceSession"><spanclass="viewcode-link"><spanclass="pre">[source]</span></span></a><aclass="headerlink"href="#onnxruntime.InferenceSession"title="Permalink to this definition">¶</a></dt>
<dd><p>This is the main class used to run a model. The next release (ORT 1.10) will require explicitly setting the providers parameter if you want to use execution providers other than the default CPU provider (as opposed to the current behavior of providers getting set/registered by default based on the build flags) when instantiating InferenceSession.</p>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">NodeArg</span></code><aclass="headerlink"href="#onnxruntime.NodeArg"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">name</span></code><aclass="headerlink"href="#onnxruntime.NodeArg.name"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">shape</span></code><aclass="headerlink"href="#onnxruntime.NodeArg.shape"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">type</span></code><aclass="headerlink"href="#onnxruntime.NodeArg.type"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">RunOptions</span></code><aclass="headerlink"href="#onnxruntime.RunOptions"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">log_severity_level</span></code><aclass="headerlink"href="#onnxruntime.RunOptions.log_severity_level"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">log_verbosity_level</span></code><aclass="headerlink"href="#onnxruntime.RunOptions.log_verbosity_level"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">logid</span></code><aclass="headerlink"href="#onnxruntime.RunOptions.logid"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">only_execute_path_to_fetches</span></code><aclass="headerlink"href="#onnxruntime.RunOptions.only_execute_path_to_fetches"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">terminate</span></code><aclass="headerlink"href="#onnxruntime.RunOptions.terminate"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">class</span></em><codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.</span></code><codeclass="sig-name descname"><spanclass="pre">SessionOptions</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">enable_cpu_mem_arena</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_cpu_mem_arena"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">enable_mem_pattern</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_mem_pattern"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">enable_profiling</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.enable_profiling"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">execution_mode</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.execution_mode"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">execution_order</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.execution_order"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">graph_optimization_level</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.graph_optimization_level"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">inter_op_num_threads</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.inter_op_num_threads"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">intra_op_num_threads</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.intra_op_num_threads"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">log_severity_level</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.log_severity_level"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">log_verbosity_level</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.log_verbosity_level"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">logid</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.logid"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">optimized_model_filepath</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.optimized_model_filepath"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">profile_file_prefix</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.profile_file_prefix"title="Permalink to this definition">¶</a></dt>
<emclass="property"><spanclass="pre">property</span></em><codeclass="sig-name descname"><spanclass="pre">use_deterministic_compute</span></code><aclass="headerlink"href="#onnxruntime.SessionOptions.use_deterministic_compute"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.backend.</span></code><codeclass="sig-name descname"><spanclass="pre">is_compatible</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">model</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">device</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="o"><spanclass="pre">**</span></span><spanclass="n"><spanclass="pre">kwargs</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.is_compatible"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.backend.</span></code><codeclass="sig-name descname"><spanclass="pre">prepare</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">model</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">device</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="o"><spanclass="pre">**</span></span><spanclass="n"><spanclass="pre">kwargs</span></span></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"><spanclass="pre">onnxruntime.backend.</span></code><codeclass="sig-name descname"><spanclass="pre">run</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">model</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">inputs</span></span></em>, <emclass="sig-param"><spanclass="n"><spanclass="pre">device</span></span><spanclass="o"><spanclass="pre">=</span></span><spanclass="default_value"><spanclass="pre">None</span></span></em>, <emclass="sig-param"><spanclass="o"><spanclass="pre">**</span></span><spanclass="n"><spanclass="pre">kwargs</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.run"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname"><spanclass="pre">onnxruntime.backend.</span></code><codeclass="sig-name descname"><spanclass="pre">supports_device</span></code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n"><spanclass="pre">device</span></span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#onnxruntime.backend.supports_device"title="Permalink to this definition">¶</a></dt>