natgillin/translations-raw huggingface dataset:
The Visualisation state of a KCachegrind window includes: the primary and secondary event type chosen for display, the function grouping (used in the Function Profile list and entity colouring), the profile parts whose costs are to be included in visualisation, an active cost entity (e. g. a function selected from the function profile dockable), a selected cost entity. This state influences visualisations.
Стан візуалізації вікна & kcachegrind; включає: основні і вторинні типи подій, обраних для показу, групування функцій (використовується у списку Функції профілювання і розфарбування елементів), частини профілювання, чиї вартості слід включити до візуалізації, активний елемент вартості (наприклад, вибраної на панелі функцій функції), вибраний елемент вартості. Цей стан впливає на візуалізацію.
Visualisations always are shown for one, the active, cost entity. When a given visualisation is not appropriate for a cost entity, it is disabled (e. g. when selecting an ELF object in the group list by double-clicking, source annotation for an ELF object make no sense).
Вміст панелі перегляду завжди відповідатиме одному, активному, елементу вартості. Якщо певна панель не відповідає елементу вартості, її буде вимкнено (наприклад, якщо вибрати об’ єкт & ELF; у списку групи, коментарі у вихідних кодах не матимуть сенсу).
For example, for an active function, the callee list shows all the functions called from the active one: one can select one of these functions without making it active; also, if the call-graph is shown nearside, it will automatically select the same function.
Наприклад, для активної функції, у списку викликаних буде показано всі функції, які було викликано з активної функції: ви можете обрати одну з цих функцій, не роблячи її активною; крім того, якщо граф викликів показано поруч, у ньому також буде вибрано відповідну функцію.
Parts of the GUI
Частини графічного інтерфейсу користувача
Sidedocks (Dockables) are side windows which can be placed at any border of an KCachegrind window. They always contain a list of cost entities sorted in some manner.
Бічні панелі є бічними вікнами, які можна розташовувати поряд з будь- якою з меж вікна & kcachegrind;. На них завжди міститься список елементів вартості, впорядкованих у той же спосіб.
Function Profile. The Function Profile is a list of functions showing inclusive and exclusive cost, call count, name and position of functions.
Профіль функцій є списком, у якому буде показано включену і виключну вартість, кількість викликів, назву і позицію функцій.
The visualisation area, typically the right part of a KCachegrind main window, is made up of one (default) or more Tab Views, either lined up horizontally or vertically. Each tab view holds different visualisation views of only one cost entity at a time. The name of this entity is given at the top of the tab view. If there are multiple tab views, only one is active. The entity name in the active tab view is shown in bold and determines the active cost entity of the KCachegrind window.
Область перегляду, яка типово розташована у правій частині головного вікна & kcachegrind;, складається з одної (типової) або декількох вкладок, вирівняних горизонтально або вертикально. У кожному з переглядів вкладки містяться різноманітні дані для одного окремого елемента вартості. Назву цього елемента буде показано у верхній частині вкладки. Якщо відкрито декілька вкладок, лише одна з них буде активною. Назву елемента у активному перегляді вкладок буде показано жирним шрифтом, вона визначає активний елемент вартості вікна & kcachegrind;.
Areas of a Tab View
Області у вкладках
Each tab view can hold up to four view areas, namely Top, Right, Left, and Bottom. Each area can hold multiple stacked visualisation views. The visible view of an area is selected by a tab bar. The tab bars of the top and right area are at the top; the tab bars of the left and bottom area are at the bottom. You can specify which kind of visualisation should go into which area by using the context menus of the tabs.
На кожній з вкладок може міститися до чотирьох областей перегляду, а саме верхня, права, ліва і нижня. У кожній з областей можуть міститися декілька переглядів візуалізації у вигляді стосу. Видиму частину області можна обрати за допомогою панелі вкладок. Панелі вкладок верхньої і правої областей знаходяться вгорі; панелі вкладок лівої і нижньої областей знаходяться внизу. Ви можете визначати різновид перегляду для кожної з областей за допомогою контекстних меню вкладок.
Synchronised Visualisation via Selected Entity in a Tab View
Синхронізований перегляд з вибором елемента у вкладці
Besides an active entity, each tab view has an selected entity. As most visualisation types show multiple entities with the active one somehow centred, you can change the selected item by navigating inside a visualisation (by clicking with the mouse or using the keyboard). Typically, selected items are shown in an highlighted state. By changing the selected entity in one of the visualisations of a tab view, all other visualisations in the tab view accordingly highlight the new selected entity.
Окрім активного елемента, у кожній вкладці є вибраний елемент. Оскільки у більшості з типів перегляду буде показано декілька елементів, активний елемент буде певним чином розташовано по центру, ви можете змінити вибраний елемент навігацією на панелі перегляду (клацанням кнопкою миші або за допомогою клавіатури). Типово, вибрані елементи буде підсвічено. Зміною вибраного елемента у одній з областей перегляду з вкладками, на всіх інших панелях у перегляді з вкладками буде відповідно підсвічено новий вибраний елемент.
Synchronisation between Tab Views
Синхронізація між вкладками
If there are multiple tab views, a selection change in one tab view leads to an activation change in the next (to right/ to bottom) tab view. This kind of linkage should, for example, allow for fast browsing in call graphs.
Якщо буде відкрито декілька вкладок, зміна вибраного елемента на одній з вкладок призведе до зміни активації у наступному (праворуч/ внизу) перегляді з вкладками. Цей тип прив’ язки, наприклад, забезпечує швидку навігацію графами викликів.
The layout of all the tab views of a window can be saved (see menu item View/ Layout). After duplicating the current layout (Ctrl+Plus or menu) and changing some sizes or moving a visualisation view to another area of an tab view, you can quickly switch between the old and the new layout via Ctrl+Left/ Right. The set of layouts will be stored between KCachegrind sessions of the same profiled command. You can make the current set of layouts as the default one for new KCachegrind sessions, or restore to the default layout set.
Компонування всіх переглядів з вкладками можна зберегти (за допомогою пункту меню Перегляд Розкладка). Після дублювання поточного компонування (Ctrl; + Перегляд Розкладка Здублювати) і зміни певних розмірів або пересування перегляду до іншої області перегляду з вкладками, ви можете швидко перемикатися між старим і новим компонуванням за допомогою комбінацій клавіш & Ctrl; ← і Ctrl; →. Набір компонувань буде збережено між сеансами роботи з & kcachegrind; над тією самою командою профілювання. Ви може зробити поточний набір компонувань як типовий для нових сеансів & kcachegrind; або відновити типовий набір компонувань.
The flat profile contains a group list and a function list. The group list contains all groups where cost is spent in, depending on the chosen group type. The group list is hidden when grouping is switched off.
Плоский профіль містить список груп і список функцій. У списку груп міститься перелік всіх груп, на які витрачаються ресурси системи, залежно від обраного типу груп. Список груп буде приховано, якщо групування буде вимкнено.
The function list contains the functions of the selected group (or all functions if grouping is switched off), ordered by some column, e. g. inclusive or self costs spent therein. There is a maximal number of functions shown in the list, which is configurable in Settings/ Configure KCachegrind.
У списку функцій міститься перелік функцій вибраної групи (або всіх функцій, якщо групування вимкнено), впорядкованих за певним стовпчиком, наприклад включених або власних вартостей. Існує обмеження на максимальну кількість функцій, показаних у списку, його можна налаштувати за допомогою вікна, яке відкривається пунктом меню Параметри Налаштувати & kcachegrind;.
In a profile run, multiple profile data files can be produced, which can be loaded together into KCachegrind. The Parts Overview dockable shows these, horizontally ordered according creation time; the rectangle sizes are proportional to the cost spent in the parts. You can select one or several parts to constrain the costs shown in the other KCachegrind views to these parts only.
Під час виконання профілювання може бути створено декілька файлів даних профілювання, їх можна завантажити разом у & kcachegrind;. Ці файли буде показано на панелі Огляд частин, файли буде впорядковано у відповідності до часу створення; розміри прямокутників будуть пропорційними до вартості відповідних частин. Ви можете обрати одну або декілька частин, щоб обмежити перелік вартостей, які буде показано у інших переглядах & kcachegrind;, лише цими частинами.
The parts are further subdivided: there is a partitioning and an inclusive cost split mode:
Частини поділяються на менші частини. Існує режим розбиття і розділення включеної вартості:
Partitioning: You see the partitioning into groups for a profile data part, according to the group type selected. For example, if ELF object groups are selected, you see coloured rectangles for each used ELF object (shared library or executable), sized according to the cost spent therein.
Ви побачите розбиття на групи для частини даних профілювання, відповідно до обраного типу груп. Наприклад, якщо обрано групи об’ єктів & ELF;, ви побачите розфарбовані прямокутники для кожного використаного об’ єкта & ELF; (спільної бібліотеки або виконуваного файла), їх розмір буде пропорційним до вартості використання ресурсів системи.
Inclusive Cost Split: A rectangle showing the inclusive cost of the current active function in the part is shown. This, again, is split up to show inclusive costs of its callees.
Буде показано прямокутник, що відповідає включеній вартості поточної активної функції у частині. Цей перегляд, знову, буде розділено для того, щоб показати включені вартості викликаних елементів.
This is a purely fictional 'most probable 'call stack. It is built up by starting with the current active function and adds the callers/ callees with highest cost at the top and to bottom.
Це цілком уявний « найбільш ймовірний » стек викликів. Його буде побудовано починаючи з поточної активної функції, туди буде додано виклики і викликані елементи з найвищою вартістю у верхню і нижню частину списку.
The 'Cost 'and 'Calls' columns show the cost used for all calls from the function in the line above.
У стовпчиках Вартість і Виклики буде показано вартість, використану для всіх викликів з функції у рядку, розташованому вище.
Parts Overview
Тип події
This list shows all cost types available and the corresponding self and inclusive cost of the current active function for that event type.
У списку Тип подій буде показано всі доступні типи вартості і відповідну власну і включену вартості поточної активної функції для відповідного типу події.
By choosing an event type from the list, you change the type of costs shown all over KCachegrind to be the selected one.
Вибором певного типу подій зі списку ви можете змінити тип вартостей, який буде показано у всіх інших переглядах & kcachegrind;, які буде обрано.
These lists show calls to/ from the current active function. With ''all 'callers/ callees functions are meant which can be reached in caller/ callee direction, even when other functions are in between.
Тут буде показано список викликів до/ з поточної активної функції. За допомогою панелей Всі виклики і Всі викликані функції можна переглянути всі функції, яких можна досягти вздовж ланцюжка виклики/ викликані, навіть якщо існують інші проміжні функції.
A treemap visualisation of the primary event type, up or down the call hierarchy. Each coloured rectangle represents a function; its size tries to be proportional to the cost spent therein while the active function is running (however, there are drawing constrains).
Перегляд деревоподібної карти основного типу подій, вгору або вниз ієрархією викликів. Кожному розфарбованому прямокутнику відповідає функція, розмір прямокутника приблизно пропорційний до вартості у ресурсах системи виконання активної функції (крім того, існують певні обмеження малювання).
For the Caller Map, the graph shows the nested hierarchy of all callers of the current activated function; for the Callee Map, it shows the nested hierarchy of all callees of the current activated function.
У разі показу Карта викликів на графі буде показано ієрархію всіх функцій, що викликали поточну активовану функцію. У разі показу Карти викликаних буде показано ієрархію всіх функцій викликаних активованою функцією.
Appearance options can be found in the in the context menu. To get exact size proportions, choose 'Hide incorrect borders '. As this mode can be very time consuming, you may want to limit the maximum drawn nesting level before. 'Best' determinates the split direction for children from the aspect ratio of the parent. 'Always Best 'decides on remaining space for each sibling. 'Ignore Proportions' takes space for function name drawing before drawing children. Note that size proportions can get heavily wrong.
Параметри вигляду можна знайти у контекстному меню. Щоб отримати точні пропорції, позначте пункт Пропустити некоректні границі. Оскільки побудова графів у подібному режимі є досить тривалою, ймовірно, вам слід обмежити максимальний рівень вкладеності до початку побудови. За вибору Найкращого режиму напрямок поділу для дочірніх елементів буде визначено зі співвідношення сторін батьківського елемента. За вибору режиму Завжди найкращий вибір відбуватиметься на основі доступного простору для елементів одного рівня. У режимі Ігнорувати пропорції прості для показу назви функції буде забрано перед малюванням дочірніх елементів. Зауважте, що пропорції за розмірами можуть бути дуже неточними.
Keyboard navigation is available with the left/ right arrow keys for traversing siblings, and up/ down arrow keys to go a nesting level up/ down. 'Return 'activates the current item.
Ви можете скористатися клавішами зі стрілками ліворуч/ праворуч для пересування між елементами одного рівня, клавіші зі стрілочками вгору/ вниз можна використати для пересування між рівнями вкладеності. Клавіша & Enter; активує поточний елемент.
This view shows the call graph around the active function. The shown cost is only the cost which is spent while the active function was actually running; i. e. the cost shown for main() - if it 's visible - should be the same as the cost of the active function, as that is the part of inclusive cost of main() spent while the active function was running.
У цьому перегляді буде показано граф викликів навколо активної функції. Показана вартість є лише вартістю, яку було витрачено під час виконання самої активної функції; тобто вартість, показану для функції main (), — якщо вона є видимою, — має бути тією самою, що і вартість активної функції, оскільки вона є частиною включеної вартості main (), витраченої під час виконання активної функції.
For cycles, blue call arrows indicate that this is an artificial call added for correct drawing which actually never happened.
Для циклів сині стрілки викликів позначатимуть, що ви маєте справу з штучним викликом, доданим для правильного показу, цей виклик ніколи не виконується.
If the graph is larger than the widget area, a bird 's eye view is shown in one edge. There are similar visualisation options as for the Call Treemap; the selected function is highlighted.
Якщо розмір графу перевищує площу віджета, у одному з кутів буде показано елемент загального перегляду. Існують подібні до карти викликів параметри візуалізації, вибрану функцію буде підсвічено.
The annotated source/ assembler lists show the source lines/ disassembled instructions of the current active function together with (self) cost spent while executing the code of a source line/ instruction. If there was a call, lines with details on the call are inserted into the source: the (inclusive) cost spent inside of the call, the number of calls happening, and the call destination.
У коментованих списках вихідних кодів/ кодів асемблера буде показано рядки вихідних кодів/ дизасембльовані інструкції поточної активної функції, а також (власну) вартість на виконання коду рядка вихідних кодів/ інструкції. Якщо це був виклик, у вихідні коди буде вставлено рядки з подробицями щодо виклику: (включену) вартість виклику, кількість виконаних викликів і призначення викликів.
Opens an empty toplevel window into which you can load profile data. This action is not really needed, as File/ Open will give you a new toplevel window when the current one shows already some data.
Відкрити порожнє вікно верхнього рівня, у яке ви можете завантажите дані профілювання. Насправді, цей пункт не дуже то і потрібен, оскільки за допомогою пункту меню Файл Відкрити... ви зможете відкрити нове вікно верхнього рівня, якщо у поточному вікні вже показано певні дані.
Pops up the File Open Dialogue to choose a profile data file to be loaded. If there is some data already shown in the current toplevel window, this will open a new window; if you want to open additional profile data in the current window, use File/ Add.
Відкрити діалогове вікно відкриття файла & kde;, у якому ви зможете обрати файл даних профілювання, який слід завантажити. Якщо у поточному вікні верхнього рівня вже показано певні дані, програма відкриє нове вікно; якщо ви бажаєте додати дані профілювання у поточне вікно, скористайтеся пунктом меню Файл Додати....
The name of profile data files usually ends in.. -, where and are optional and are used for multiple profile data files belonging to one application run. By loading a file ending only in., eventually existing data files for this run, but with additional endings, are loaded too.
Назви файлів даних профілювання зазвичай завершуються на. pid. частина - ідентифікатор потоку, де частина і ідентифікатор потоку є необов’ язковими, а pid і частина використовуються для декількох файлів даних профілювання, що стосуються одного запуску програми. Якщо завантажити файл, назва якого завершується лише на pid, буде завантажено не лише файли даних для цього запуску, але і файли з додатковими суфіксами.
Example: If there exist profile data files cachegrind. out.123 and cachegrind. out.123.1, by loading the first, the second will be automatically loaded too.
Якщо існують файли даних профілювання cachegrind. out. 123 і cachegrind. out. 123. 1, після завантаження першого з файлів другий файл буде завантажено автоматично.
Adds a profile data file to the current window. Using this, you can force multiple data files to be loaded into the same toplevel window even if they are not from the same run as given by the profile data file naming convention. This can, for example, be used for nearside comparison.
Додати файл даних профілювання у поточне вікно. За допомогою цього пункту ви можете примусити програму до завантаження декількох файлів даних до одного вікна верхнього рівня, навіть якщо вони не належать до одного запуску програми згідно до угоди щодо назв файлів даних профілювання. Цим можна, наприклад, скористатися для порівняльного аналізу.
Reload the profile data. This is most interesting after another profile data file was generated for an already loaded application run.
Перезавантажити дані профілювання. Таке перезавантаження найцікавіше після того, як було створено інший файл даних профілювання для вже завантаженого запуску програми.
& kcachegrind; is a helpful at a later stage in software development, called Profiling. If you do n't develop applications, you do n't need & kcachegrind;.
& kcachegrind; корисний на останніх стадіях розробки програмного забезпечення, які називаються профілюванням. Якщо ви не є розробником програм, вам не потрібен & kcachegrind;.
What is the difference between 'Incl. 'and 'Self'?
У чому різниця між « Вкл. » і « Власна »?
These are cost attributes for functions regarding some event type. As functions can call each other, it makes sense to distinguish the cost of the function itself ('Self Cost ') and the cost including all called functions ('Inclusive Cost'). 'Self 'is sometimes also referred to as 'Exclusive' costs.
Це атрибути вартості для функцій, що стосуються подій певного типу. Оскільки функції можуть викликати одна одну, має сенс відрізняти вартість самої функції (« власну вартість ») і вартість разом з всіма викликаними функціями (« включену вартість »). « Власну » вартість іноді також називають « виключною ».
So, for example, for main(), you will always have a inclusive cost of almost 100%, whereas the self cost is negligible when the real work is done in another function.
Отже, наприклад, для main () ви завжди матимете включену вартість близьку до 100%, тоді як власна вартість цієї функції є незначною, оскільки справжню роботу виконує інша функція.
The toolbar/ menubar of my KCachegrind looks so spartanic. Is this normal?
Панель інструментів або смужка меню мого & kcachegrind; виглядають якось аж занадто спрощеними. Це нормально?
Obviously KCachegrind is wrongly installed on your system. It is recommended to compile it with the installation prefix to be your system wide KDE base directory like configure --prefix=/ opt/ kde3; make install. If you choose another directory like $HOME/ kde, you should set the environment variable KDEDIR to this directory before running KCachegrind.
Очевидно, у вашій системі & kcachegrind; було встановлено неправильно. Рекомендуємо вам зібрати програму з префіксом встановлення, що збігається з базовою текою & kde; у вашій теці, наприклад, configure -- prefix= / opt/ kde4; make install. Якщо ви оберете іншу теку, наприклад, $HOME / kde, вам слід додати до значення змінної середовища KDEDIR цю теку до запуску & kcachegrind;.
If I double-click on a function down in the Call Graph View, it shows for the function main the same cost as the selected function. Is n't this supposed to be constant 100%?
Якщо навести вказівник на позначку функції у перегляді графу викликів і двічі клацнути лівою кнопкою миші, для функції main () буде показано ту саму вартість вибраної функції. Хіба вартість всіх функцій рівна сталій 100%?
You have activated a function below main() with cost less than main(). For any function, only that part of the full cost of the function is shown, that is spent while the activated function is running; that is, the cost shown for any function can never be higher than the cost of the activated function.
Якщо ви активуєте вкладену функцію main () її вартість буде меншою за вартість main (). Для будь- якої функції, буде показано лише частину повної вартості функції, цю вартість було витрачено на виконання активованої функції; тобто, вартість, показана для будь- якої функції ніколи не може перевищувати вартість активованої функції.
Cost Entities
Елемент вартості
Cost Entity: An abstract item related to source code to which event counts can be attributed. Dimensions for cost entities are code location (e. g. source line, function), data location (e. g. accessed data type, data object), execution location (e. g. thread, process) and tuples or triples of the aforementioned positions (e. g. calls, object access from statement, evicted data from cache).
Абстрактний елемент, пов’ язаний з вихідними кодами, з якими можна пов’ язати кількість подій. Вимірами для елементів вартості є адреси коду (наприклад, рядок вихідних кодів, функція), адреси даних (наприклад, тип даних для доступу, об’ єкт даних), адреса виконання (наприклад, потік, процес) і пари або трійки вище наведених позицій (наприклад, виклики, доступ до даних з інструкції, витискання даних з кешу).
Event Types
Вартість подій
Event Costs: Sum of events of some event type occurring while the execution is related to some cost entity. The cost is attributed to the entity.
Сума вартостей подій певного типу, які трапляються під час виконання, пов’ язаного з певним елементом вартості. Вартість буде прив’ язано до елемента.