| Operators |
get_system — Get current value of HALCON system parameters.
get_system( : : Query : Information)
The operator get_system returns information concerning the currently activated HALCON system parameters.
Readable and Writable Parameters
get_system returns information about all parameters that are set with set_system. For more information on read- and writeable parameters, please refer to the reference documentation of set_system.
Read-Only Parameters
The following system parameters can be queried:
Versions:
The currently used variant of HALCON: HALCON XL, which allows images larger than 32768 x 32768 ('true') or HALCON, which restricts the maximal image size to 32768 x 32768 ('false').
HALCON version number, e.g.: 10.0.
The currently running HALCON edition. The returned value is one out of 'progress' or 'steady'.
Creation date of the HALCON library.
Revision number of the HALCON library, e.g.: 1.
File version number of the HALCON library. The number is made up of the HALCON version number, the revision number, and the build number (e.g.: 11.0.1.2). Trailing zeros after the version number are omitted (e.g.: 11.0.1 if build number is 0 or 11.0 if revision number and build number are 0).
Upper Limits:
Maximum number of input parameters.
Maximum number of output parameters.
Maximum number of input control parameters.
Maximum number of output control parameters.
Maximum number of windows.
Graphic:
Returns the value that may have been set with set_window_attr('window_title',...). If nothing has been set yet, the string 'default' is returned.
Parallelization:
Returns the number of processors that HALCON has found on the hardware it is running on.
Returns the number of threads the last operator was using for automatic operator parallelization. Only operators that were run by the calling thread and support automatic parallelization are considered. Note that using this parameter in HDevelop works only in run mode, not in single step mode.
Returns all split levels the last operator was using for automatic parallelization. Only operators that were run by the calling thread and support automatic parallelization are considered. If the last operator was not parallelized, the string 'false' is returned. Note that using this parameter in HDevelop works only in run mode, not in single step mode.
Other:
The host IDs of the computer that can be used for licensing HALCON.
Total number of the available HALCON procedures ('num_sys_proc' + 'num_user_proc').
Number of the system procedures (supported procedures).
Number of the user defined procedures (see also 'Extension Package Programmer's Manual').
Byte order of the processor ('msb_first' or 'lsb_first').
Name of the operating system of the computer on which the HALCON process is being executed. Note that for all Windows versions, 'Windows NT' is returned. Use the parameter 'operating_system_version' to query the precise version.
Version number of the operating system of the computer on which the HALCON process is being executed. To decode the Windows version numbers, please refer to the website information on operating systems and version numbers provided by Microsoft.
Name of the computer on which the HALCON process is being executed. On Windows systems, if the computer is part of a cluster the name of the cluster is returned, not the name of the local computer. If the name cannot be determined, an empty string is returned.
Locale setting that is used by the runtime environment for encoding system strings (according to the locale category LC_CTYPE). The result corresponds to the result of the system C function setlocale or the result of the shell command 'locale' called in a Linux terminal. In general, it contains data about the language, the country, and the code page or code set - under Windows, for instance, 'German_Germany.1252' or under Linux 'en_US.utf8'. Note, that the names on Linux and Mac are not clearly defined because they depend on the system and the current configuration. Thus, the code set can be set to 'utf8' or 'UTF-8', or may completely be missing. On systems that do not support locale an empty string is returned.
Code set that is used by the runtime environment for encoding system strings (according to the locale category LC_CTYPE). In contrast to 'locale_raw', this result contains only the code set or code page and no information about language and country. The code set is returned in a normalized way so that it can easier be used in tests. The result contains only lowercase letters and numbers, with different results for Windows code pages and Linux / Mac code sets, as the code sets used are usually not identical. Under Windows typically the code page number prefixed by 'cp' is returned, e.g., 'cp1252' (for code page 1252 which is commonly used in the western world and correlates widely with latin-1) or 'cp932' (which correlates with ShiftJIS, which is common in Japan). Common results under Linux and Mac are 'utf8' (which is the default locale on Mac and most of the recent Linux distributions), 'iso885915' (Latin-9), 'shiftjis', and 'ascii' (referred to as ANSI_X3.4-1968, US-ASCII, POSIX, C).
Flag, if the HALCON version is a 64 bit version ('true') or not, i.e., if it is a 32 bit version ('false').
Name of the HALCON architecture of the running HALCON process.
Path to the currently loaded HALCON library including the file name.
Amount of temporary memory used by the last operator in byte. The return value is only defined if set_check('memory') was called before.
Flag, if the processor supports MMX operations ('true') or not ('false').
Flag, if the processor supports SSE operations ('true') or not ('false').
Flag, if the processor supports SSE2 operations ('true') or not ('false').
Flag, if the processor supports SSE3 operations ('true') or not ('false').
Flag, if the processor supports SSSE3 operations ('true') or not ('false').
Flag, if the processor supports SSE41 operations ('true') or not ('false').
Flag, if the processor supports SSE42 operations ('true') or not ('false').
Flag, if the processor supports AVX operations ('true') or not ('false').
Flag, if the processor supports AVX2 operations ('true') or not ('false').
Flag, if the processor supports AVX-512F operations ('true') or not ('false').
Flag, if the processor supports AVX-512DQ operations ('true') or not ('false').
Flag, if the processor supports AVX-512BW operations ('true') or not ('false').
Flag, if the processor supports AVX-512ER operations ('true') or not ('false').
Flag, if the processor supports AVX-512CD operations ('true') or not ('false').
Flag, if the graphic card supports the acceleration of the hidden surface removal used in create_shape_model_3d, find_shape_model_3d, project_shape_model_3d, and project_object_model_3d. The minimum requirements are OpenGL 2.0 and the extensions GL_EXT_framebuffer_object and GL_ARB_texture_float. Please note that these features are not available via Windows Remote Desktop or X11 forwarding.
Default size of the graphic stack associated to every HALCON window. See set_system for further details.
The maximum amount of temporary memory required so far for a thread, in bytes. The first element of the tuple contains the value for the current thread, while any following elements contain the values of currently idle threads from the thread pool.
The maximum is reset when the temporary memory cache mode is set to 'idle'.
Returns a tuple containing the block sizes of all temporary memory blocks currently cached in the thread's temporary memory cache, in bytes.
Returns a tuple containing the block sizes of all temporary memory blocks currently cached in the global temporary memory reservoir, in bytes.
Returns a flag if the legacy handel mode is activated.
CUDA support for deep learning:
Returns 'true' if the CUDA library could be loaded.
Returns the version of the CUDA library. If the CUDA library could not be loaded, -1 is returned. In case the GPU does not meet the minimum system requirements (as described in the Installation Guide), 'cuda_version' returns 7708 even if 'cuda_loaded' has returned 'true'.
Returns the names of available devices that are compatible with CUDA.
Returns 'true' if the cuDNN library could be loaded.
Returns the version of the cuDNN library. If the cuDNN library could not be loaded, -1 is returned.
Returns 'true' if the cuBLAS library could be loaded.
Returns the version of the cuBLAS library. If the cuBLAS library could not be loaded, -1 is returned.
Desired system parameter.
Default value: 'init_new_image'
List of values: '3d_model_dir', 'alloctmp_max_blocksize', 'alloctmp_max_used', 'alloctmp_min_blocksize', 'avx2_enable', 'avx2_supported', 'avx512bw_enable', 'avx512bw_supported', 'avx512cd_enable', 'avx512cd_supported', 'avx512dq_enable', 'avx512dq_supported', 'avx512er_enable', 'avx512er_supported', 'avx512f_enable', 'avx512f_supported', 'avx_enable', 'avx_supported', 'backing_store', 'border_shape_models', 'bundle_version', 'byte_order', 'cancel_draw_result', 'clip_region', 'clock_mode', 'cublas_loaded', 'cublas_version', 'cuda_devices', 'cuda_loaded', 'cuda_version', 'cudnn_loaded', 'cudnn_version', 'current_runlength_number', 'database', 'default_font', 'do_low_error', 'edition', 'empty_region_result', 'example_dir', 'extern_alloc_funct', 'extern_free_funct', 'file_version', 'filename_encoding', 'flush_file', 'flush_graphic', 'global_mem_cache', 'halcon_64', 'halcon_arch', 'halcon_dir', 'halcon_xl', 'height', 'help_dir', 'hostids', 'hostname', 'icon_name', 'image_cache_capacity', 'image_dir', 'image_dpi', 'init_new_image', 'int2_bits', 'int_zooming', 'language', 'last_update', 'legacy_handle_mode', 'library_fullname', 'locale_codeset', 'locale_raw', 'lut_dir', 'max_connection', 'max_inp_ctrl_par', 'max_inp_obj_par', 'max_outp_ctrl_par', 'max_outp_obj_par', 'max_window', 'mmx_enable', 'mmx_supported', 'neighborhood', 'no_object_result', 'num_proc', 'num_sys_proc', 'num_user_proc', 'ocr_trainf_version', 'opengl_compatibility_mode_enable', 'opengl_context_cache_enable', 'opengl_hidden_surface_removal_available', 'opengl_hidden_surface_removal_enable', 'operating_system', 'operating_system_version', 'parallelize_operators', 'pregenerate_shape_models', 'processor_num', 'read_halcon_files_encoding_fallback', 'reentrant', 'revision', 'seed_rand', 'sse2_enable', 'sse2_supported', 'sse3_enable', 'sse3_supported', 'sse41_enable', 'sse41_supported', 'sse42_enable', 'sse42_supported', 'sse_enable', 'sse_supported', 'ssse3_enable', 'ssse3_supported', 'store_empty_region', 'temp_mem', 'temporary_mem_cache', 'temporary_mem_reservoir', 'temporary_mem_reservoir_size', 'thread_num', 'thread_pool', 'timer_mode', 'tsp_cancel_draw_result', 'tsp_clip_region', 'tsp_current_runlength_number', 'tsp_empty_region_result', 'tsp_height', 'tsp_init_new_image', 'tsp_legacy_handle_mode', 'tsp_neighborhood', 'tsp_no_object_result', 'tsp_store_empty_region', 'tsp_temporary_mem_cache', 'tsp_temporary_mem_cache_block_sizes', 'tsp_temporary_mem_reservoir', 'tsp_thread_num', 'tsp_used_split_levels', 'tsp_used_thread_num', 'tsp_width', 'update_lut', 'use_window_thread', 'version', 'width', 'window_name', 'write_halcon_files_encoding', 'x_package'
Current value of the system parameter.
The operator get_system returns the value 2 (H_MSG_TRUE) if the parameters are correct. Otherwise an exception is raised.
Foundation
| Operators |