get_system
— Abfragen von Informationen über die aktuellen HALCON-Systemparameter.
get_system( : : Query : Information)
get_system
liefert Informationen über die
aktuellen HALCON-Systemparameter zurück.
Lesbare- und schreibbare Parameter
Der Operator get_system
liefert Informationen über alle Parameter, die
mit set_system
gesetzt wurden zurück. Weitere Informationen über diese Parameter
können in der Dokumentation zu set_system
nachgelesen werden.
Nur lesbare Parameter
Folgende Systemparameter können abgefragt werden:
Versionen:
Verwendete Variante von HALCON: HALCON XL, das Bilder größer als 32768 x 32768 erlaubt ('true' ) oder HALCON, bei dem die maximale Bildgröße auf 32768 x 32768 beschränkt ist ('false' ).
Versionsnummer von HALCON, z.B.: 11.0.
Verwendete HALCON Edition. Der Rückgabewert kann die Strings 'progress' oder 'steady' annehmen.
Datum der Erzeugung der HALCON-Bibliothek.
Revisionsnummer von HALCON, z.B.: 1.
Dateiversionsnummer der HALCON Bibliothek. Sie setzt sich aus der HALCON Versionsnummer, der Revisionsnummer und der Buildnummer zusammen, (z.B.: 11.0.1.2). Der Versionsnummer anhängende Nullen entfallen (z.B.: 11.0.1 für Buildnummer 0 oder 11.0 für Revisionsnummer 0 und Buildnummer 0).
Obergrenzen:
Maximale Anzahl von Eingabeparametern.
Maximale Anzahl von Ausgabeparametern.
Maximale Anzahl von Eingabe-Steuerparametern.
Maximale Anzahl von Ausgabe-Steuerparametern.
Maximale Anzahl von Fenstern.
Grafik:
Liefert den Namen, der eventuell mit set_window_attr('window_title',...)
gesetzt wurde zurück. Falls kein Name gesetzt wurde, wird
'default' zurückgeliefert.
Parallelisierung:
Gibt die Anzahl der Prozessoren an, die in der verwendeten Hardware gefunden wurden.
Gibt die Anzahl der Threads zurück, die der letzte Operator für die automatische Parallelisierung verwendet hat. Dabei werden nur Operatoren berücksichtigt, die von dem Thread aufgerufen wurden und die automatische Parallelisierung unterstützen. Es ist zu beachten, dass dieser Parameter in HDevelop nur im Ausführmodus, nicht im schrittweisen Modus funktioniert.
Gibt alle Methoden der Parallelisierung zurück, die der letzter Operator für die automatische Parallelisierung verwendet hat. Dabei werden nur Operatoren berücksichtigt, die von dem Thread aufgerufen wurden und die automatische Parallelisierung unterstützen. Falls der letzte Operator nicht parallelisiert wurde, wird der String 'false' zurückgegeben. Es ist zu beachten, dass dieser Parameter in HDevelop nur im Ausführmodus, nicht im schrittweisen Modus funktioniert.
Sonstiges:
Die Host-IDs des Rechners, die zur Lizensierung von HALCON verwendet werden können.
Gesamtzahl der verfügbaren HALCON-Prozeduren ('num_sys_proc' + 'num_user_proc' ).
Anzahl der Systemprozeduren (unterstützte Prozeduren).
Anzahl der benutzerdefinierten Prozeduren (siehe Handbuch 'Extension Packages').
Byte-Order des Prozessors ('msb_first' oder 'lsb_first' ).
Name des Betriebssystems des Rechners, auf dem der HALCON-Prozess ausgeführt wird. Beachten Sie, dass für alle Windows-Versionen 'Windows NT' zurückgegeben wird. Der Parameter 'operating_system_version' ermöglicht es, die genaue Version abzufragen.
Versionsnummer des Betriebssystems des Rechners, auf dem der HALCON-Prozess ausgeführt wird. Die Windows-Versionsnummern können mit Hilfe der Informationen zu Betriebssystemen und Versionsnummern auf der Microsoft-Webseite entschlüsselt werden.
Name des Rechners, auf dem der HALCON-Prozess ausgeführt wird. Wenn der Rechner teil eines Windows Clusters ist, wird der Name des Clusters zurückgegeben, nicht der Name des lokalen Rechners. Kann der Rechnername nicht bestimmt werden, wird ein leerer String zurückgegeben.
In der Laufzeitumgebung verwendete Locale-Einstellung, die für die Kodierung von Systemstrings verwendet wird (entsprechend der Locale-Kategorie LC_CTYPE). Das Ergebnis entspricht direkt dem Aufruf der System-C-Funktion setlocale, bzw. dem Aufruf von locale in der Linux-Shell. Es enthält i.d.R. Informationen zu Sprache, Land und Codepage bzw. Codeset - unter Windows beispielsweise 'German_Germany.1252' oder unter Linux 'en_US.utf8' . Dabei ist zu beachten, dass unter Linux und Mac der Name nicht eindeutig ist, da der Codeset-Name von System und Konfiguration abhängt und beispielsweise 'utf8' oder 'UTF-8' sein oder auch ganz fehlen kann. Auf Systemen ohne Locale-Unterstützung wird ein leerer String zurückgegeben.
Von der Laufzeitumgebung verwendetes Codeset, das für die Kodierung von Systemstrings verwendet wird (entsprechend der Locale-Kategorie LC_CTYPE). Im Gegensatz zu 'locale_raw' enthält das Ergebnis nur die Codepage bzw. das Codeset und nicht die Sprache oder das Land. Dafür liegt das Ergebnis in normalisierter Form vor, so dass es leichter für Tests ausgewertet werden kann. Das Ergebnis enthält nur Kleinbuchstaben und Zahlen, wobei für Windows Codepages und Linux/Mac Codesets unterschiedliche Ergebnisse geliefert werden, da die verwendeten Codesets i.d.R. nicht identisch sind. Typische Ergebnisse unter Windows sind z.B. 'cp1252' (für die in der westlichen Welt verwendete Codepage 1252 - weitestgehend Latin-1) oder 'cp932' (für die in Japan verwendete Codepage 932 - ShiftJIS). Typische Ergebnisse unter Linux und Mac sind 'utf8' (entsprechend dem Default-Locale unter Mac und den meisten aktuellen Linux-Distributionen), 'iso885915' (Latin-9), 'shiftjis' und 'ascii' (für ANSI_X3.4-1968, US-ASCII, POSIX, C).
Flag, das gesetzt ist, wenn es sich um eine 64-Bit-HALCON-Version handelt ('true' ) oder nicht, wenn es sich um eine 32 Bit Version handelt ('false' ).
Name der HALCON-Architektur des laufenden HALCON-Prozesses.
Pfad zur aktuell geladenen HALCON-Bibliothek einschließlich des Dateinamens.
Bedarf an temporärem Speicher des zuletzt ausgeführten
Operators in Byte. Der Rückgabewert ist nur definiert, wenn
vor dem zu vermessenden Operator set_check('memory')
aufgerufen wurde.
Flag, das gesetzt ist, wenn der Prozessor MMX-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSE-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSE2-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSE3-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSSE3-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSE41-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor SSE42-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX2-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX512F-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX512DQ-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX512BW-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX512ER-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn der Prozessor AVX512CD-Operationen unterstützt ('true' ). Andernfalls ist es nicht gesetzt ('false' ).
Flag, das gesetzt ist, wenn die Grafikkarte die Beschleunigung
der Verdeckungsberechnung in den Operatoren create_shape_model_3d
,
find_shape_model_3d
, project_shape_model_3d
und
project_object_model_3d
unterstützt.
Mindestvoraussetzungen sind OpenGL 2.0 und die Erweiterungen
GL_EXT_framebuffer_object und GL_ARB_texture_float.
Es ist nicht möglich diese Beschleunigung über den Windows Remote
Desktop oder X11 Weiterleitung zu verwenden.
Standardgröße des Grafik-Stapels jedes HALCON-Fensters. Siehe
set_system
für weitere Details.
Die maximal verwendete Menge temporären Speichers eines Threads in Bytes. Das erste Element des Tupels enthält den Wert für den aktuellen Thread, während die übrigen Elemente die Werte von derzeit ungenutzten Threads aus dem Threadpool enthalten.
Das Maximum wird zurückgesetzt, wenn der Cachemodus für temporären Speicher auf 'idle' gesetzt wird.
Tupel, das die Größen aller temporären Speicherblöcke in Bytes enthält, die momentan vom Thread gecached werden.
Tupel, das die Größen aller temporären Speicherblöcke in Bytes enthält, die momentan im globalen temporären Speicher-Reservoir gecached sind.
Gibt zurück, ob der Legacy Handle Modus aktiviert ist.
CUDA Unterstützung für Deep Learning:
Gibt 'true' zurück, wenn die CUDA-Bibliothek geladen werden konnte.
Gibt die Version der CUDA-Bibliothek zurück. Wenn die CUDA-Bibliothek nicht geladen werden konnte, wird -1 zurückgegeben.
Gibt die Namen der verfügbaren Grafikkarten, die CUDA unterstützen, zurück.
Gibt 'true' zurück, wenn die cuDNN-Bibliothek geladen werden konnte.
Gibt die Version der cuDNN-Bibliothek zurück. Wenn die cuDNN-Bibliothek nicht geladen werden konnte, wird -1 zurückgegeben.
Gibt 'true' zurück, wenn die cuBLAS-Bibliothek geladen werden konnte.
Gibt die Version der cuBLAS Bibliothek zurück. Wenn die cuBLAS-Bibliothek nicht geladen werden konnte, wird -1 zurückgegeben.
Arm Compute Library:
Gibt 'true' zurück, wenn die Arm Compute Library geladen werden konnte, 'false' andernfalls.
Gibt die Version der Arm Compute Library zurück. Wenn die Bibliothek nicht geladen werden konnte, wird ein leerer String zurückgegeben.
Query
(input_control) attribute.name(-array) →
(string)
Gewünschter Systemparameter.
Defaultwert: 'init_new_image'
Werteliste: '3d_model_dir' , 'alloctmp_max_blocksize' , 'alloctmp_max_used' , 'alloctmp_min_blocksize' , 'available_license_files' , 'available_parameters' , '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' , 'calib_dir' , 'cancel_draw_result' , 'clip_region' , 'clock_mode' , 'cublas_loaded' , 'cublas_version' , 'cuda_devices' , 'cuda_loaded' , 'cuda_version' , 'cudnn_loaded' , 'cudnn_version' , 'current_license_info' , 'current_runlength_number' , 'database' , 'default_font' , 'disabled_operators' , 'dl_dir' , 'do_low_error' , 'edition' , 'empty_region_result' , 'example_dir' , 'expiration_date' , 'extern_alloc_funct' , 'extern_free_funct' , 'failed_license_rechecks' , 'file_version' , 'filename_encoding' , 'filter_dir' , 'flush_file' , 'flush_graphic' , 'global_mem_cache' , 'halcon_64' , 'halcon_arch' , 'halcon_dir' , 'halcon_xl' , 'height' , 'help_dir' , 'hostids' , 'hostname' , 'hthread_id' , 'icon_name' , 'image_cache_capacity' , 'image_dir' , 'image_dpi' , 'init_new_image' , 'int2_bits' , 'int_zooming' , 'is_license_valid' , 'language' , 'last_update' , 'legacy_handle_mode' , 'library_fullname' , 'licensed_hostid' , 'licensed_modules' , 'licensed_version' , '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_dir' , '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' , 'product_edition' , '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_tuple_string_operator_mode' , 'tsp_used_split_levels' , 'tsp_used_thread_num' , 'tsp_width' , 'tuple_string_operator_mode' , 'unlicensed_operators' , 'update_lut' , 'use_window_thread' , 'version' , 'width' , 'window_name' , 'write_halcon_files_encoding' , 'x_package'
Information
(output_control) attribute.value(-array) →
(integer / real / string)
Aktueller Wert des Systemparameters.
get_system
liefert den Wert 2 (H_MSG_TRUE),
falls die Parameter korrekt sind.
Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation