You are here: Start » Appendices » Deep Learning - Getting Started
Deep Learning - Getting Started
Contents
- Installation guide
- Aurora Deep Learning Library and Filters
- Aurora Deep Learning Service
- Aurora Deep Learning Examples
- Aurora Deep Learning Standalone Editor
- Logging
- Troubleshooting
- References
1. Installation guide
To use Deep Learning Filters, Library or Service with Aurora Vision Studio or Aurora Vision Library, a corresponding version of Aurora Deep Learning must be installed (the best idea is to use the newest versions of both from our website). Before installation, please check your hardware configuration.
Deep Learning is available in two versions:
- GPU version (recommended) - version working with CUDA GPU acceleration. Much faster than CPU counterpart.
- CPU version - uses only CPU, GPU is not required and used. Relatively slow, especially during training phase.
Requirements
- Graphics card compatible with CUDA toolkit. List of compatible devices can be found on this website (all CUDA devices with "Compute Capability" greater than or equal 3.5 and less than or equal 8.6). Minimum 2 GB of graphic memory is recommended. Display Driver with at least 461.33 version is required (recommended latest display driver version).
- Starting from version 5.4, tools supported in the new Service (right now Feature Detection, Anomaly Detection 2, Object Classification and Point Location are implemented, the rest of the tools will appear soon) support cards with "Compute Capability" equal 8.9.
- At least 3.5 GB disk space for program files, SSD recommended.
- At least 8 GB RAM memory.
- 64-bit processor, Intel i5, i7 or better are recommended. AVX support is required.
- Windows 10 or 11.
Known issues
If you are getting Access Denied errors during updating (or uninstalling), close all processes that may use previously installed Deep Learning files, like programs that need Deep Learning Library, Aurora Vision Studio, Aurora Vision Executor and so on.
2. Aurora Deep Learning Library and Filters
Aurora Deep Learning provides Filters for usage in Aurora Vision Studio in 64-bit version. 32-bit version is not supported.
Aurora Deep Learning also provides Library (with Training Api) in 64-bit version (32-bit version is not supported). It is installed in Library subdirectory of main installation directory. It contains more subfolders:
- bin/x64 – a directory containing DLL file (AVLDL.dll) for 64-bit applications written in C++. This library is common for all supported versions of Microsoft Visual Studio and for Debug|Release configurations. This directory also contains AvlDl.Net.dll file (along with its documentation in AvlDl.Net.xml file), which is .Net wrapper for AVLDL.dll.
- include – a directory containing all header (.h) files for Library (AVLDL.h) and Training Api (Api.h).
- lib/x64 – a directory containing import library (AVLDL.lib) for 64-bit applications. This file needs to be linked into a program that uses Library or Training Api as it serves as intermediary to AVLDL.dll.
Installer sets environment variable named AVLDL_PATH5_4
containing path to Library subdirectory.
Exemplary use of AVLDL_PATH5_4
is presented in C++ examples distributed with Aurora Deep Learning.
3. Aurora Deep Learning Service
The Service is installed into the Service subdirectory in the main installation directory. Upon launching the Service, a new icon should appear in the system tray.
Running filters does not require having the Service working in the background (in fact, this is even discouraged). On the other hand, training a model always requires running the Service, regardless of the tool used.
Please note: to open the Deep Learning Editor, place a relevant Deep Learning filter (DL_DetectFeatures, DL_ClassifyObject, DL_LocatePoints, DL_DetectAnomalies1, DL_LocateObjects, DL_DetectAnomalies2 or DL_SegmentInstances) in the Program Editor, enter its Properties and click on the icon next to the inModelId.ModelDirectory parameter.
Alternatively, to open the Deep Learning Editor from a DL_*_Deploy filter (DL_DetectFeatures_Deploy, DL_ClassifyObject_Deploy, DL_LocatePoints_Deploy, DL_DetectAnomalies1_Deploy, DL_LocateObjects_Deploy, DL_DetectAnomalies2_Deploy or DL_SegmentInstances_Deploy), enter its properties and click on the icon next to the inModelDirectory parameter.
In order to make a non-default graphics card the target device for model inference, you need to change its index in the settings.xml file in the UsedGPUIndex field. The file can be found at: %LocalAppData%\Aurora Vision\Aurora Deep Learning 5.4. Alternatively, just click on the Open Log Directory button in the Deep Learning Service GUI to be redirected inside this folder.
The list of available graphics cards and their indexes is displayed in the Deep Learning Service GUI window.
4. Aurora Deep Learning Examples
Examples are installed only if corresponding component has been selected during installation.
Examples for Aurora Vision Studio are installed into %ProgramData%/Aurora Vision/Aurora Vision Studio 5.4 Professional/Examples directory. It means that they are located next to other Studio examples, which simplifies opening them from Studio. All Deep Learning Examples are prefixed with "Deep Learning".
Examples using Aurora Deep Learning Library and Training Api are located in the Public Documents system folder (e.g. C:\Users\Public\Documents\Aurora Deep Learning 5.4\Examples on Windows 10). Shortcut to this directory can be found in the Start Menu after the installation.
5.Aurora Deep Learning Standalone Editor
Standalone Deep Learning comes in both runtime and professional version installers. It can be very useful to performing training on client site.
Standalone Editor can be executed using command line with following parameters:
DeepLearningEditor.exe path [--alwaysOnTop] [--disableChangingLocation] [--language "language-code"]
Where:
- path - path to directory with Deep Learning model,
- --alwaysOnTop (optional) - setting this flag does not allow Deep Learning Editor to be covered by other windows.
- --disableChangingLocation (optional) - user cannot change the model path from the editor.
- --language (optional) - language to be used in the editor. Possible values "en","de","ja","pl","zh_hans","zh_hant".
Standalone editor can be started using additional HMI controls or Execute filter.
6. Logging
Deep Learning Service and Filters logs some information during execution to several files, located at %LocalAppData%/Aurora Vision/Aurora Deep Learning 5.4 directory. Total disk space used by these files should not exceed several MB. Files older than a couple of days are automatically deleted. More information are provided in the documentation of DL_ConfigureLogging filter.
If this disk space requirement is unacceptable, Service can be executed in "minimal logging" mode. This can be achieved by running run_service_minimal_logging.bat script, located at Service installation folder. Note, that it will not lead to any observable performance improvement.
7. Troubleshooting
Most common problems encountered by our clients can be separated into two groups:
-
Problems with installed Nvidia drivers - most problems occurs during loading Deep Learning Filters into Aurora Vision Studio.
Most common error from the console log:
Unable to load filter library "(...)AvlDlFilters.dll". Win32 error: The specified procedure could not be found.
-
Resources exhaustion during the training - training takes to much GPU/System memory that cannot be handled by current system. In such state your computer may
lost stability and different problems my occur.
Most common errors:
Out of memory. Try freeing up hard disk space, using less training images, increasing downsample or resizing images to smaller ones.
orService disconnected.
Common reported problems and solutions:
- Invalid or old version of graphical card drivers - verify if your GPU card have supported version of drivers. It can be checked in Window's Control Panel.
-
Corrupted installation of the GPUs drivers - verify if your GPU drivers are installed properly. In some cases full re-installation of Nvidia drivers may be necessary.
Please verify if following files are found on your computer C:\Windows\System32\nvml.dll and C:\Windows\System32\nvcuda.dll. - Deep Learning product version is too old for latest version of the latest Aurora Vision Studio - Update Deep Learning to the latest version.
-
Changes in environment PATH variable may affects how Deep Learning filters works - Remove all paths from PATH variable which may point to Nvidia CUDA runtime DLL. Please verify
if command
where cudnn_ops_infer64_8.dll
returns no results. - GPU card doesn't meet minimum software requirements - in some cases older GPU cards may encounter runtime problems during training or inference.
References
See also:
- Machine Vision Guide: Deep Learning - Deep Learning technique overview,
- Creating Deep Learning Model - how to use Deep Learning Editor.
Previous: Quick Start Guide for C/C++ Programmers |