.. _neuron_compiler_faq: Neuron Compiler FAQ (``neuron-cc``) =================================== .. contents:: Table of contents :local: :depth: 1 Where can I compile to Neuron? --------------------------------- The one-time compilation step from the standard framework-level model to NEFF binary may be performed on any EC2 instance or even on-premises. We recommend using a high-performance compute server of choice (C5 or z1d instance types), for the fastest compile times and ease of use with a prebuilt `DLAMI `__. Developers can also install Neuron in their own environments; this approach may work well for example when building a large fleet for inference, allowing the model creation, training and compilation to be done in the training fleet, with the NEFF files being distributed by a configuration management application to the inference fleet. My current Neural Network is based on FP32, how can I use it with Neuron? ------------------------------------------------------------------------- Developers who want to train their models in FP32 for best accuracy can compile and deploy them with Neuron. The Neuron compiler automatically converts FP32 to internally supported datatypes, such as FP16 or BF16. You can find more details about FP32 data type support and performance and accuracy tuning in :ref:`neuron-cc-training-mixed-precision`. The Neuron compiler preserves the application interface - FP32 inputs and outputs. Transferring such large tensors may become a bottleneck for your application. Therefore, you can improve execution time by casting the inputs and outputs to FP16 or BF16 in the ML framework prior to compilation for Inferentia. What are some of the important compiler defaults I should be aware of? ----------------------------------------------------------------------- The compiler compiles the input graph for a single NeuronCore by default. Using the :option:`--neuroncore-pipeline-cores` option directs the compiler to partition so as to run on a specified number of NeuronCores. This number can be less than the total available NeuronCores on an instance. See :ref:`inferentia-arch` for more information on NeuronCores. Which operators does Neuron support? --------------------------------------- see :ref:`neuron-supported-operators`. You can also use the "neuron-cc list-operators" command on the cli to list the operators. See :ref:`neuron-cc-list-operators` If your model contains operators missing from the above list, and you can't reach your performance goals, please post a message on the Neuron developer forum or open a github issue to let us know. Any operators that Neuron doesn't support? --------------------------------------------- Models with control-flow and dynamic shapes are not supported. You will need to partition the model using the framework prior to compilation. See the :ref:`neuron-cc`. Will I need to recompile again if I updated runtime/driver version? ---------------------------------------------------------------------- The compiler and runtime are committed to maintaining compatibility for major version releases with each other. The versioning is defined as major.minor, with compatibility for all versions with the same major number. If the versions mismatch, an error notification is logged and the load will fail. This will then require the model to be recompiled. I have a NEFF binary, how can I tell which compiler version ----------------------------------------------------------- generated it?** We will bring a utility out to help with this soon. How long does it take to compile? ------------------------------------ It depends on the model and its size and complexity, but this generally takes a few minutes.