Программа beltrami версия 0.1.4

Проект начат 2000-07-18; Последние изменения 2004-08-05

1  Загрузка

2  Файл readme.koi

beltrami --- Численное решение уравнения Бельтрами

ПОДДЕРЖИВАЕМЫЕ ОКРУЖЕНИЯ

GNU/Linux/GMP or GNU/Linux

http://www.gnu.org    GNU/Linux 
http://www.mingw.org  MinGW --- Minimalist GNU For Windows
http://www.swox.com/gmp/ GNU Multiple Precision Library

КОМПИЛЯЦИЯ

Имеется два варианта компиляции.

1) Если нет длиннной арифметики (для бедных ;). Введите 

make -f makefile.nomp (или gmake-f makefile.nomp) 

в директории, где находятся тексты программы.

2) С библиотекой длинной арифметики GNU Multiple Precision
(GMP). Введите 'make' (or 'gmake') в директории с исходниками. 
Компиляция может не завершиться по следующим причинам: (а) 
библиотека GMP не установлена; (b) обёртка длинной арифметики для C++
<gmpxx.h> не установлена. 

В обоих случаях (a) и (b) загрузите GNU MP с указанного выше адреса;

  ./configure --enable-cxx; make; make install


КРАТКАЯ ИНСТРУКЦИЯ

См. описание алгоритма и пример в файле example/example.tex


Условия использования описаны в файле LICENSE.koi

3  Использование и сводка опций

user@computer$ ./beltrami --help
Usage: beltrami [OPTIONS] FILE
Mandatory arguments to long options are mandatory for short options too
Default values are given in square brackets
  -o, --output=NAME    output results to NAME instead of standard output
  -i, --iterations=N   do N iterations [10]
  -a, --all-info=L     set verbose level to L [0]
  -d, --daripa         use Daripa's approach for computing operator T
  -k, --khmelev        use identity T=PDz to compute T
  -l, --lin-daripa     use linear approximation to compute T using [Daripa]
  -p, --precision=P    number of bits per number [54]
  -f, --fprecision=D   Set output format %.f
  -g, --gprecision=D   Set output format %.g
  -e, --eprecision=D   Set output format %.e
The following options are mutually exclusive (def --Rtransform)
  -T --Ttransform      do integral transform T (once)
  -P --Ptransform      do integral transform P (once)
  -S --Stransform      do transform S^N, where S=mu*(T+1)
  -R --Rtransform      do integral transform P S^N + I, I for identity
  -D --Dztransform     computes derivative f_z (in polar coordinates)
  -Z --Dzbartransform  computes derivative f_zbar (in polar coordinates)
  -M --Mutransform     computes Beltrami differential f_zbar/f_z
  -F --FFTtransform    do FFT transform
  -I --iFFTtransform   do inverse FFT transform
  -s --skipFFT         skip FFT before and after T and P transforms
The following long options allow to normalize solutions. 
  --zero_i=i0       If one of these four options is used, all of them
  --zero_j=j0          must be used. In that case h[i0][j0] will be set to 0
  --one_i=i1           and h[i1][j1] will be set to 1.
  --one_j=j1           You can shorten these options for --0i, --0j, --1i,--1j

  -q, --quiet          do not send any messages to stderr
  -h, --help           display this help and exit
  -m, --man            display complete description
  -v, --version        display version and exit

4  Описание

user@computer$ ./beltrami --man
<Пропущена информация, присутствующая в предыдущем разделе>


This program solves the Beltrami equation on finite plane, using
integration transforms T and P. It accepts on input the file
in the following format
M N
r[1]
...
r[M]
mu[0][0]
mu[1][0] mu[1][1] ... mu[1][N-1]
...
mu[M][0] mu[1][1] ... mu[M][N-1]

Integers M and N define the number of nodes in polar coordinates,
where M is the number of radiuses, and N is the number of nodes in
angular coordinates. All nodes of grid are equispaces in angular
direction. The number N *must* be the power of 2. In radial
coordinate, the radiuses must be defined (real numbers) r[1], ..., r[M].
By default r[0]=0.0.

The values of Beltrami differential should be given in the table,
following r[1..M]. In this table mu[i][j] corresponds to 
mu(r[i]*exp(2*Pi*j/N)). For r[0] only one value mu[0][0] must be given.

The example of the table follows:
4 8
0.1
0.2
0.3
0.4
(3,1)
(-0,1) (-3,1) (-0,1) (-3,1) (-7,5) (-4,1) (-7,5) (-4,1)
(-6,3) ( 7,1) (-6,3) ( 7,1) ( 1,2) (-2,4) ( 1,2) (-2,4)
(-6,3) ( 7,1) (-6,3) ( 7,1) ( 1,2) (-2,4) ( 1,2) (-2,4)
(-7,5) (-4,1) (-7,5) (-4,1) (-0,1) (-3,1) (-0,1) (-3,1)

EXIT CODES

The program exits with code 0, only in case it has done
what it was meant to do. In all other cases the exit code.
is non-zero. For example --help option exits with code
ERROR_HELP. The errors related to interaction with operating
system has code >=16. In future versions more exit codes
can be added, but the current exit code will remain as is.
  THE TABLE OF EXIT CODES:
   0 ERROR_OK
   1 ERROR_VERSION
   2 ERROR_HELP
   3 ERROR_DESCRIPTION
   4 ERROR_NO_ARGUMENT
   5 ERROR_WRONG_ARGUMENT
  16 ERROR_SERIOUS
  16 ERROR_INTERNAL
  17 ERROR_MALLOC
  18 ERROR_STAT_FILE
  19 ERROR_EMPTY_FILE
  20 ERROR_OPEN_FILE_READ
  21 ERROR_OPEN_FILE_WRITE
  22 ERROR_OPEN_FILE_TMP
  23 ERROR_WRITE_FILE
  24 ERROR_INPUT_FORMAT

5  Развитие программы

2000-07-18

2004-01-24

2004-02-07

2004-02-08

2004-03-22

2004-03-23

2004-03-24

2004-03-26

2004-03-28

2004-03-29

2004-03-30

2004-03-31

2004-07-18

2004-08-05

6  Лицензия

Программа доступна с http://www.math.toronto.edu/dkhmelev/PROGS/

Автор:

Дмитрий Викторович Хмелёв dkhmelev((at))math.toronto.edu [замените ((at)) на @, чтобы получить настоящий адрес - антиспам]

119 992, Москва, Ленинские горы, МГУ, 1 Гум. корп., Филологический факультет, Лаборатория общей и компьютерной лексикологии и лексикографии.

УСЛОВИЯ ИСПОЛЬЗОВАНИЯ

Эта программа может свободно распространяться на условиях лицензии GNU версии два или выше (см. прилагаемый файл COPYING с условиями распространения).

Результаты, полученные с использованием этой программы должны ссылаться на её использование. Пример ссылки:

Д.В. Хмелёв http://www.math.toronto.edu/dkhmelev/PROGS/

Более того, Вы должны проинформировать автора о публикации.

Используя эту программу Вы соглашаетесь с условиями использования.

ОТСУТСТВИЕ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ

ПОСКОЛЬКУ НАСТОЯЩАЯ ПРОГРАММА РАСПРОСТРАНЯЕТСЯ БЕСПЛАТНО, ГАРАНТИИ НА НЕЕ НЕ ПРЕДОСТАВЛЯЮТСЯ В ТОЙ СТЕПЕНИ, В КАКОЙ ЭТО ДОПУСКАЕТСЯ ПРИМЕНИМЫМ ПРАВОМ. НАСТОЯЩАЯ ПРОГРАММА ПОСТАВЛЯЕТСЯ НА УСЛОВИЯХ "КАК ЕСТЬ". ЕСЛИ ИНОЕ НЕ УКАЗАНО В ПИСЬМЕННОЙ ФОРМЕ, АВТОР И/ИЛИ ИНОЙ ПРАВООБЛАДАТЕЛЬ НЕ ПРИНИМАЕТ НА СЕБЯ НИКАКИХ ГАРАНТИЙНЫХ ОБЯЗАТЕЛЬСТВ, КАК ЯВНО ВЫРАЖЕННЫХ, ТАК И ПОДРАЗУМЕВАЕМЫХ, В ОТНОШЕНИИ ПРОГРАММЫ, В ТОМ ЧИСЛЕ ПОДРАЗУМЕВАЕМУЮ ГАРАНТИЮ ТОВАРНОГО СОСТОЯНИЯ ПРИ ПРОДАЖЕ И ПРИГОДНОСТИ ДЛЯ ИСПОЛЬЗОВАНИЯ В КОНКРЕТНЫХ ЦЕЛЯХ, А ТАКЖЕ ЛЮБЫЕ ИНЫЕ ГАРАНТИИ. ВСЕ РИСКИ, СВЯЗАННЫЕ С КАЧЕСТВОМ И ПРОИЗВОДИТЕЛЬНОСТЬЮ ПРОГРАММЫ, НЕСЕТ ЛИЦЕНЗИАТ. В СЛУЧАЕ ЕСЛИ В ПРОГРАММЕ БУДУТ ОБНАРУЖЕНЫ НЕДОСТАТКИ, ВСЕ РАСХОДЫ, СВЯЗАННЫЕ С ТЕХНИЧЕСКИМ ОБСЛУЖИВАНИЕМ, РЕМОНТОМ ИЛИ ИСПРАВЛЕНИЕМ ПРОГРАММЫ, НЕСЕТ ЛИЦЕНЗИАТ.

ЕСЛИ ИНОЕ НЕ ПРЕДУСМОТРЕНО ПРИМЕНЯЕМЫМ ПРАВОМ ИЛИ НЕ СОГЛАСОВАНО СТОРОНАМИ В ДОГОВОРЕ В ПИСЬМЕННОЙ ФОРМЕ, АВТОР И/ИЛИ ИНОЙ ПРАВООБЛАДАТЕЛЬ, КОТОРЫЙ МОДИФИЦИРУЕТ И/ИЛИ РАСПРОСТРАНЯЕТ ПРОГРАММУ НА УСЛОВИЯХ НАСТОЯЩЕЙ ЛИЦЕНЗИИ, НЕ НЕСЕТ ОТВЕТСТВЕННОСТИ ПЕРЕД ЛИЦЕНЗИАТОМ ЗА УБЫТКИ, ВКЛЮЧАЯ ОБЩИЕ, РЕАЛЬНЫЕ, ПРЕДВИДИМЫЕ И КОСВЕННЫЕ УБЫТКИ (В ТОМ ЧИСЛЕ УТРАТУ ИЛИ ИСКАЖЕНИЕ ИНФОРМАЦИИ, УБЫТКИ, ПОНЕСЕННЫЕ ЛИЦЕНЗИАТОМ ИЛИ ТРЕТЬИМИ ЛИЦАМИ, НЕВОЗМОЖНОСТЬ РАБОТЫ ПРОГРАММЫ С ЛЮБОЙ ДРУГОЙ ПРОГРАММОЙ И ИНЫЕ УБЫТКИ). АВТОР И/ИЛИ ИНОЙ ПРАВООБЛАДАТЕЛЬ В СООТВЕТСТВИИ С НАСТОЯЩИМ ПУНКТОМ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ДАЖЕ В ТОМ СЛУЧАЕ, ОНИ БЫЛИ ПРЕДУПРЕЖДЕНЫ О ВОЗМОЖНОСТИ ВОЗНИКНОВЕНИЯ ТАКИХ УБЫТКОВ.