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>
<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>