onnxruntime/docs/C_API.md

24 lines
1.1 KiB
Markdown
Raw Normal View History

2018-11-20 00:48:22 +00:00
# C API
## Features
2018-11-23 04:56:43 +00:00
2018-11-20 00:48:22 +00:00
* Creating an InferenceSession from an on-disk model file and a set of SessionOptions.
* Registering customized loggers.
* Registering customized allocators.
* Registering predefined providers and set the priority order. ONNXRuntime has a set of predefined execution providers,like CUDA, MKLDNN. User can register providers to their InferenceSession. The order of registration indicates the preference order as well.
* Running a model with inputs. These inputs must be in CPU memory, not GPU. If the model has multiple outputs, user can specify which outputs they want.
* Converting an in-memory ONNX Tensor encoded in protobuf format, to a pointer that can be used as model input.
* Setting the thread pool size for each session.
* Dynamically loading custom ops.
2018-11-23 04:56:43 +00:00
## Very simplified outline of how to use it
2018-11-23 04:56:43 +00:00
1. Include [onnxruntime_c_api.h](/include/onnxruntime/core/session/onnxruntime_c_api.h).
2. Call OrtCreateEnv
3. Create Session: OrtCreateSession(env, model_uri, nullptr,...)
2018-11-26 22:57:54 +00:00
4. Create Tensor
1) OrtCreateAllocatorInfo
2) OrtCreateTensorWithDataAsONNXValue
5. OrtRun
2018-11-23 04:56:43 +00:00