ConvertAll ReadMe

# Руководство по ConvertAll

## программа для конвертирования величин

Автор Doug Bell
Версия 0.8.0

## Содержание

Введение

Возможности

Лицензия и распространение

Системные требования

Linux

Windows

Установка

Linux

Windows

Использование ConvertAll

Основы

Комбинирование величин

Нелинейное конвертирование

Ускорение набора

Настройки

Режим командной строки (без GUI)

История версий

Вопросы, Комментарии, Критика?

## Введение

Для чего писать ещё один конвертер величин? Да, их множество. Но, я не нашёл такого, который бы работал так, как я хочу.

С помощью ConvertAll можно комбинировать величины как вам захочется. Если Вы хотите конвертировать дюймы за декаду, запросто. Или перевести величину из метр-фунтов. Или морских миль в кубе. Величины не должны иметь смысл для кого-то ещё.

Я не преследую коммерческой цели и делаю эту программу бесплатной для использования, распространения и изменения, так как она не включает в себя никаких проприетарных программ. Если Вам понравилась программа, поделитесь с другими своей находкой. Можете также сообщить своё мнение о программе - мой электронный адрес: doug101 собака bellz точка org.

## Возможности

Базовая величина для конвертации может быть напечатана (с автозавершением) или выбрана из списка.

По мере ввода названия величины, список величин автоматически фильтруется и содержит только величины с совпадающими словами.

Величину можно выбирать как по аббревиатуре, так и по полному имени.

Величины можно комбинировать с операторами "*" и "/".

Величину можно возвести в степень (квадрат, куб и т.д.) с помощью оператора "^".

Величины в знаменателе можно группировать используя круглые скобки.

Нелинейные величины, такие как температура, тоже могут быть конвертированы.

Недавно использованные величины можно выбрать из меню.

Значение величин можно вводить как со стороны «Из», так и «В» для конвертации в обе стороны.

Базовые математические выражения могут использоваться вместо значений.

Настраиваемый формат представления результата.

Базе включает более 500 величин.

Формат базы величин позволяет с лёгкостью добавить дополнительные величины.

С помощью командной строки возможно выполнить конвертацию без GUI.

Пользовательский интерфейс и база величин доступны на Английском, Французском, Немецком, Русском и Испанском языках.

## Лицензия и распространение

ConvertAll является свободным программным обеспечением ; Вы можете распространять и / или изменять его в соответствии с условиями GNU General Public License , опубликованной Фондом свободного программного обеспечения, либо версии 2 Лицензии, либо (по вашему выбору ) любой более поздней версии.

Эта программа распространяется в надежде, что будет полезна, но БЕЗ ВСЯКОЙ ГАРАНТИИ. Смотри файл `LICENSE` для подробной информации.

## Системные требования

### Linux

ConvertAll зависит от следующих библиотек:

Python (Версии 3.4 или выше)

Qt (Версии 5.4 или выше - смотри Qt Project для подробной информации)

PyQt ( Версии 5.4 или выше - смотри Riverbank для подробной информации )

### Windows

Используя файлы дистрибутива, ConvertAll должен работать на любом компьютере под Windows XP, Vista, 7, 8 или 10.

## Установка

### Linux

Распакуйте исходные файлы convertall из tar архива, затем перейдите в директорию `ConvertAll` в терминале. Для стандартной установки просто запустите команду с правами root:

`python install.py`

Если в Вашем дистрибутиве по умолчанию используется Python 2.x, необходимо подставить `python3` вместо `python` в этих командах.

Чтобы посмотреть все возможные параметры установки, используйте: `python install.py -h`.

Чтобы установить ConvertAll с отличным префиксом (по умолчанию `/usr/local`), используйте: `python install.py -p /путь/``для/установки`

### Windows

Чтобы установить для всех пользователей, запустите файл `ConvertAll-x.x.x-install-all.exe`. Потребуются права администратора.

Для пользовательской установки (права администратора не требуются), запустите файл `ConvertAll-x.x.x-install-user.exe`.

Для установки портативной версии, запустите файл `ConvertAll-x.x.x-install-user.exe,` `снимите отметки установки ярлыков и деинсталлятора,` `а также` `выберите установку портативной версии.`

## Использование ConvertAll

### Основы

Просто напечатайте имя величины в поле «Из величины». Пока Вы набираете название величины список будет фильтроваться, чтобы показать только подходящие величины. Фильтрация производится по словам входящим в величину (начиная с начала). Вы можете напечатать полностью название/аббревиатуру величины или нажать клавишу «Enter» для выбора величины подсвеченной (синие буквы) в списке. Конечно же, простое нажатие мышкой на элементе списка выберет величину в поле ввода. Также можно использовать клавиши курсора для выбора величин в списке расположенных рядом.

Повторите выбор величины в поле «В величину». Когда завершите выбор и если величины совместимы, то поле для ввода значений под списком станет активным. Значение величины можно указать в любом из полей, а в другом будет отображён результат конвертации.

### Комбинирование величин

Настоящая сила ConvertAll заключается в возможности комбинирования нескольких величин. Просто напечатайте имена величин с операторами '*' или '/' между ними. Это даёт возможность получить величины типа "ft * lbf" или "mi / hr". Символ '^' используется для возведения в степень, например "m^3" или "ft * lbm / sec^2". Его также можно использовать для получения величин типа "sec^-1" (в секунду), или переключения операции умножения или деления ("ft * sec^-2" равнозначно "ft / sec^2").

Умножение и деление имеют одинаковый приоритет, поэтому обрабатываются слева на право. Скобки могут быть использованы для группировки знаменателя. Например "м / сек / кг" можно записать как "м / (сек * кг)". Вариант со скобками вероятно менее запутывающий.

Кнопки под полями ввода величин также могут быть использованы для вставки операторов после величины ближайшей к курсору. Кнопки возведения в степень заменяют экспоненту. Кнопки умножения и деления добавят операторы "*" и "/".

Также, выбор величины из списка заменит величину на ближайшую к курсору.

Кнопка «Очистить величину» под кнопками операторов используется для очистки поля выбора величины.

Кнопка «Фильтр» используется для отображение одного типа величин в списке. Учтите, что не будут показаны величины образующие другой тип в комбинации.

### Нелинейное конвертирование

Конвертирование некоторых величин нелинейное. Примером такой величины является Фаренгейт. Нелинейные величины отмечены в колонке комментариев.

Такие величины могут быть конвертированы только, если они не комбинированы с другими величинами и не возведены в степень. Иначе результат будет неточным.

### Ускорение набора

Когда набираете имена величин пробелы игнорируются, поэтому их можно пропускать. Также игнорируются множественные формы величин. Для квадрата или куба величин (положительная степень 2 и 3) символ "^" вводить не обязательно.

Когда частично введённая величина подсвечена в списке (синие буквы) нажатие «Enter» завершит имя. Можно использовать кнопки курсора (вверх и вниз) для выбора другой величины из списка, при нажатии «Enter» активная величина в поле ввода будет заменена.

Кнопка «Недавняя величина» открывает меню недавно использованных величин и комбинаций величин. Текущая комбинация величин полностью заменяется выбранной из этого меню.

Клавиша «Tab» используется для переключения между полями величин "Из" или "В", а также полями значения величин.

Значение для конвертации можно вводить с любой стороны в "Из" или "В". Можно использовать как стандартную, так и научную запись значения, или выражение включающее нормальные математические операторы (+, -, *, /, **), а также круглые скобки.

### Настройки

Кнопка "Настройки..." позволяет изменить некоторые параметры установленные по умолчанию. Изменения автоматически сохраняются и при следующем запуске ConvertAll будет использовать последние установленные параметры.

Первый раздел включает в себя настройки представления результата, включая научное представление и количество знаков после запятой. Имейте в виду, что установка маленького числа знаков после запятой может повлиять на точность результата. Рекомендуется шесть и более знаков (восемь по умолчанию).

В следующем разделе можно установить количество недавно использованных величин, которые будут запоминаться. При установке нулевого значения, кнопки «Недавние величины» будут отключены. Далее можно включить автоматическую загрузку последней использованной величины при запуска приложения.

Есть возможность скрыть кнопки текстовых операторов (первая строка) и кнопки величин (вторая строка). Ей можно воспользоваться для экономии места, если операторы вводятся с клавиатуры.

Также можно настроить цвет текстовых полей с помощью кнопок расположенных ниже.

### Режим командной строки (без GUI)

Конвертирование можно выполнить из командной строки (консоль Linux или DOS) без использования графического интерфейса. Введите команду ("convertall" для Linux, "convertall_dos" для Windows), значение, величина из которой и величина в которую (разделённые пробелами) провести конвертацию. Величины содержащие пробелы необходимо взять в кавычки. Или их можно ввести в интерактивном режиме, использую "-i" параметр ("convertall -i" для Linux, "convertall_dos -i" для Windows).

После выполнения конвертации, ConvertAll запросит новое значение величины для аналогичной конвертации. Также можно ввести "n" для начала новой конвертации, "r" чтобы поменять местами величины или "q" для выхода.

Для более детального списка параметров, используйте "-h" параметр ("convertall -h" для Linux, "convertall_dos -h" для Windows).

## История версий

### Апрель 4, 2018 - Release 0.7.4

Новые функции:

Добавлен файл запуска для версии Linux для использования в меню.

Добавлен параметр для отмены сохранения позиции и размера окна при запуске.

Обновления:

Добавлен US drill bit gauge sizes как нелинейная величина.

Добавлены величины gigabit и terabit.

Изменено определение величины liter per 100 km в Немецкой локализации в соответствии с Английской версией.

### Октябрь 15, 2017 - Release 0.7.3

Обновления:

Добавлена величина boiler horsepower.

Исправления:

Fixed a crash if a zero value is entered when the engineering notation option is enabled.

Исправлена проблема инициализации проявляющаяся на некоторых версиях Python.

### Февраль 20, 2017 - Release 0.7.2

Исправления:

Fix a crash due to an overflow error when typing part of an exponent in the denominator of the second unit.

Avoid flipping the preceding operator between multiplication and division as a unit exponent of 0.5 is typed.

### Февраль 4, 2017 - Release 0.7.1 (Linux only)

Исправления:

Изменена устаревшая проверка зависимости в установщике для Linux – теперь проверяется наличие Qt5 библиотек.

Fixed a timing issue in the Linux installer so that byte-compiled files do not have old timestamps.

### Январь 8, 2017 - Release 0.7.0

Новые функции:

Dual unit lists have been replaced with a single list that works with the active unit line editor.

As a unit is typed, the listing of units is reduced to only include units that match the typed words.

The unit list can be sorted by clicking on the column headings.

The unit list can be filtered to only show units of a certain type.

Simple unit exponents (positive 2 and 3) can be typed with just the number (leaving out the "^" character).

Now permits decimals to be entered for unit exponents, supporting roots of units.

ConvertAll переведён с библиотек Qt4 на Qt5.

Обновления:

Since the main unit list can now be searched, sorted and filtered, the Unit Finder Dialog has been removed.

Added the British Std Wire Gauge non-linear unit.

Added the ton imperial unit.

Added the cable nautical unit.

Added the MBH (1000 Btu/hr) unit.

Added Cape foot, square perch and rood units.

Исправления:

Corrected some unit definitions in the French translation, including avogadro's number, lambert, poise and the gravitational constant.

### Сентябрь 10, 2015 - Release 0.6.1

Новые функции:

Added an option to output results in engineering notation (a version of scientific notation with exponents divisible by three).

Добавлен русский перевод. Спасибо vantu5z за перевод.

Обновления:

Добавлена величина dram mass.

Добавлены величины fluid dram и minim volume, для US и Imperial версий.

Добавлена величина smoot length.

Добавлена аббревиатура "dm" для величины decimeter length.

Добавлен комментарий "avoirdupois" для applicable mass и weight величин.

Добавлен комментарий "fresh water" для applicable depth-based pressure величин.

Обновлён немецкий перевод. Спасибо Thomas Helmke за перевод.

Добавлены некоторые MSVC библиотеки DLL для инсталлятора Windows, чтобы предотвратить ошибки на компьютерах, где они отсутствуют.

Уточнены некоторые сообщения об ошибках в зависимостях для инсталлятора Linux.

Исправлены ошибки:

Fixed an error in the unit data formula for the AWG area unit.

Changed the value of the caliber unit to be equivalent to inches (typical written usage), not hundredths of an inch (typical verbal usage).

### Февраль 1, 2014 - Release 0.6.0

Новые функции:

ConvertAll has been ported from Python 2 to Python 3. This porting includes some code cleanup.

Added an option to automatically load the last used units at startup.

Added an introductory tip dialog box that explains combined units. There is also an option to hide this dialog.

There is an additional Windows installer for users without administrator rights and for portable installations.

Added a Windows installer option to add a config file to the program's directory for portable installations. If that file is present, no config files will be written to users' directories.

Обновления:

The Windows binaries are built using more recent Python, Qt and PyQt libraries.

The user interface and unit data language translations are now included in the main installation files.

Added the long ton unit (Imperial version of the ton).

Added the kilopond unit as a synonym of kilogram-force.

Added the micron of Hg pressure unit.

Added the lunar distance (LD) astronomical distance unit.

Added the rack unit (height of an electrical rack).

Added the versta Russian length unit.

Исправлены ошибки:

Fixed the operation of the "Clear" button in the Unit Finder dialog.

Fixed a problem with the definition of the BTU unit in the French translation.

### Ноябрь 2, 2011 - Release 0.5.2

Обновления:

Added the microliter volume unit.

Added the galileo acceleration unit.

Added the stremma land area unit.

Bug Fixes:

Changed the method of identifying a "unitless" portion of a unit to avoid falsely reporting incompatibility between some units when using language translations.

### Март 31, 2011 - Release 0.5.1

Обновления:

Added the link length unit.

Added US survey variations of the mile and chain length units.

Added the centigray radiation dose unit.

Use DOS newline characters in the Windows version of the unit data file for easier editing by users.

Исправлены ошибки:

Fixed incorrect definition of the rad radiation dose unit (it was off by a factor of 10).

### Май 2, 2010 - Обновление перевода 0.5.0b

Обновления:

Added a Spanish translation. The French and German translations remain unchanged.

### Апрель 23, 2010 - Release 0.5.0

Новые функции:

Multiplication and division operators now have the same precedence. In previous versions of ConvertAll, a series of units after a division symbol were assumed to be in the denominator. Now, a division operator only affects the unit (or the unit group in parenthesis) immediately after the operator.

Parenthesis are now supported to group units in the denominator of a combined unit. For example, ""m / sec / kg" can also be entered as "m / (sec * kg)".

"Recent Unit" buttons have been added that open a menu of recently used units and unit combinations. A unit selected from the menu will replace the current unit combination. There is also a new option dialog entry that controls the maximum length of this menu.

Обновления:

Added the tonne force metric force unit.

Added hundredweight long and hundredweight short mass units.

Added an American Wire Gauge (AWG) area unit in addition to the existing AWG diameter unit.

Added the tonne oil equivalent and the tonne coal equivalent energy units.

Added the ton refrigeration power unit.

Added the darcy and millidarcy permeability units.

French and German translations have been added for the user interface and the unit data. To use them, download and install the "convertall-i18n..." file for your platform (in addition to installing the standard ConvertAll package).

Исправлены ошибки:

Fixed problems with running in the command line mode from Linux consoles without X11 present.

### Сентябрь 24, 2009 - Release 0.4.3

Новые функции:

Prepared ConvertAll for translation efforts by properly handling Unicode characters in unit data and by marking internal program strings for translation. Volunteers for translating ConvertAll into other languages are welcome.

Обновления:

Added solar mass and pennyweight mass units.

Added therm and thermie energy units.

Added gauss and maxwell magnetic units.

Added the US survey foot length unit.

Added the mpg imp mileage unit.

Changed the value of the point unit from the old American point to the more modern desktop publishing point.

Исправлены ошибки:

A critical QString conversion bug that caused ConvertAll to not run with the latest version of PyQt (4.5.4) was fixed.

Command line quiet mode was fixed to avoid an interactive prompt when bad unit data is entered.

### Май 28, 2008 - Release 0.4.2

Обновления:

Added the "liter per 100 km" unit for fuel consumption.

Исправлены ошибки:

Changed the "mach" unit from 331.46 m/s to 340.29 m/s. It is now correct for STP conditions (15 degrees C). The previous value was for 0 degrees C.

Fixed a bug that could hide messages about errors in a manually edited unit data file.

### Январь 22, 2008 - Release 0.4.1

Новые функции:

An optional command line mode was added to do conversions without the graphical interface. Enter the command ("convertall"), the number, the from unit and the to unit (separated by spaces) to do the conversion. For a more detailed list of options, enter "convertall -h" on the command line.

Обновления:

The icon used for ConvertAll has been updated. Thanks to Ricardo Berlasso for the new artwork.

Alternate units have been added for kilobyte, megabyte, etc., marked "IEC std". These convert using powers of 10, rather than powers of 2.

Troy pounds and troy ounces have been added.

Gigapascal, hectopascal and megabar have been added.

Hogshead units for wine and beer have been added.

The Swedish mil unit of distance has been added.

The Thai rai and ngaan units of land area have been added.

### Октябрь 5, 2006 - Release 0.4.0

Новые функции:

ConvertAll was ported to the Qt4 library. This involved a significant rewrite of the code. The previous versions used Qt3.x on Linux and Qt2.3 on Windows. Benefits include updated widgets and removal of the non-commercial license exception in Windows.

Обновления:

On Windows, the ConvertAll.ini file has been moved from the installation directory to a location under the "Documents and Settings" folder. This avoids problems on multi-user systems and for users with limited access rights.

### Октябрь 5, 2006 - Release 0.3.2

Обновления:

Added Imperial (UK) gallons, quarts, pints and fluid ounces.

Added gigagram and teragram units.

Added the pound-mole unit and clarified that the existing mole is a gram-mole.

### Февраль 14, 2005 - Release 0.3.1

Обновления:

Added the decare unit for land area.

The Linux installer has been updated to be more robust and give more install directory options.

Исправлены ошибки:

The barn unit, used in particle physics, was corrected. It had been incorrectly listed as a length unit instead of an area unit.

### Март 11, 2004 - Release 0.3.0

Новые функции:

A unit finder window was added to allow the unit list to be filtered and searched.

The size and position of the main and finder windows are now saved at exit.

A new option allows the operator text entry buttons (x, /, ^2, ^3 and Clear Unit) to be hidden.

An install program has been added for windows.

Исправлены ошибки:

Fixed Linux install script problems with certain versions of Python.

### Ноябрь 18, 2003 - Release 0.2.4

Обновления:

Keyboard shortcuts and tab-focus order for the main dialog have been improved.

An install script was added for Linux and Unix systems.

The windows build now uses Python version 2.3 and PyQt version 3.8.

### Март 24, 2003 - Release 0.2.3

Обновления:

When an expression using division is entered for the number to be converted, floating point division is now used even if the entries are integers (Python 2.2 or greater only).

Mouse wheels are now supported in the unit lists.

Icon files are now provided with the distribution files.

### Май 28, 2002 - Release 0.2.2a

Исправлены ошибки:

A fix of the Windows binary only. Fixes major problems by upgrading the library version to PyQt 3.2.4.

### Май 16, 2002 - Release 0.2.2

Обновления:

ConvertAll has been ported to Qt 3.x. It now works with both Qt 2.x and 3.x using the same source code.

The help/readme file has been rewritten and now includes section links.

The binaries for windows have been updated to Python 2.2 and PyQt 3.2 (but are still using Qt 2.3 Non-commercial).

### Сентябрь 17, 2001 - Release 0.2.1

Исправлены ошибки:

Some window captions and icons were corrected.

A window maximizing bug was fixed.

### Август 20, 2001 - Release 0.2.0

Новые функции:

A major rewrite was done of the conversion engine.

A new data file format makes it easier to add and verify units.

The unit name and abbreviation are now listed separately for better sorting and searching.

Entering of units has been improved by changing operator precedence, by ignoring spaces and plurals, and by changing the partial selection list highlight.

An expression can now be used for the number to be converted.

Обновления:

Many additional units were added to the database.

For MS Windows users, the binary files were upgraded to PyQt Version 2.5.

### Август 10, 2001 - Release 0.1.1

Новые функции:

Added color controls to the options dialog.

Обновления:

The convertall.ini file on windows was moved to the program directory.

Исправлены ошибки:

Fixed problems with using the same unit twice in a combined unit.

Fixed an occasional shutdown when auto-completing.

Fixed a problem with the updating of the unit label.

### Июль 28, 2001 - Release 0.1.0

Начальный релиз.

## Вопросы, Комментарии, Критика?

Со мной можно связаться по электронной почте: doug101 собака bellz точка org
Приветствуются различные отзывы, включая сообщения о найденных Вами ошибках. Также Вы можете переодически проверять наличие каких либо обновлений на www.bellz.org.