exponenta event banner

ellipj

Эллиптические функции Якоби

Описание

пример

[SN,CN,DN] = ellipj(U,M) возвращает эллиптические функции Якоби SN, CN, и DN вычисляется для соответствующих элементов аргумента U и параметр M. Исходные данные U и M должен иметь одинаковый размер или U или M должен быть скалярным.

пример

[SN,CN,DN] = ellipj(U,M,tol) вычисляет эллиптические функции Якоби с точностью tol. Значение по умолчанию tol является eps. Увеличение tol для менее точного, но более быстрого вычисляемого ответа.

Примеры

свернуть все

Найти эллиптические функции Якоби для U = 0.5 и M = 0.25.

[s,c,d] = ellipj(0.5,0.25)
s = 0.4751
c = 0.8799
d = 0.9714

Постройте график эллиптических функций Якоби для -5≤U≤5 и M = 0.7.

M = 0.7;
U = -5:0.01:5;
[S,C,D] = ellipj(U,M);
plot(U,S,U,C,U,D);
legend('SN','CN','DN','Location','best')
grid on
title('Jacobi Elliptic Functions sn,cn,dn')

Figure contains an axes. The axes with title Jacobi Elliptic Functions sn,cn,dn contains 3 objects of type line. These objects represent SN, CN, DN.

Создайте график поверхности эллиптической функции Якоби для допустимого диапазона M и -5≤U≤5.

[M,U] = meshgrid(0:0.1:1,-5:0.1:5);
S = ellipj(U,M);
surf(U,M,S)
xlabel('U')
ylabel('M')
zlabel('sn')
title('Surface Plot of Jacobi Elliptic Function sn')

Figure contains an axes. The axes with title Surface Plot of Jacobi Elliptic Function sn contains an object of type surface.

Значение по умолчанию tol является eps. Найти время выполнения со значением по умолчанию для произвольного M использование tic и toc. Увеличение tol в 1000 раз и найдите время выполнения. Сравните время выполнения.

tic
ellipj(0.253,0.937)
ans = 0.2479
toc
Elapsed time is 0.375388 seconds.
tic
ellipj(0.253,0.937,eps*1000)
ans = 0.2479
toc
Elapsed time is 0.025766 seconds.

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

Входные аргументы

свернуть все

Входной массив, заданный как скаляр, вектор, матрица или многомерный массив. U ограничивается реальными значениями. Если U является нескалярным, M должен быть скаляром или нескаляром того же размера, что и U.

Типы данных: single | double

Входной массив, заданный как скаляр, вектор, матрица или многомерный массив. M может принимать значения 0≤ м ≤1. Если M является нескаляром, U должен быть скаляром или нескаляром того же размера, что и M. Сопоставить другие значения M в этот диапазон с использованием преобразований, описанных в уравнениях 16.10 и 16.11 [1].

Типы данных: single | double

Точность результата, определяемая как неотрицательное вещественное число. Значение по умолчанию: eps.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Выходные аргументы

свернуть все

Эллиптическая функция Якоби sn, возвращаемая как скаляр, вектор, матрица или многомерный массив.

Эллиптическая функция Якоби cn, возвращаемая как скаляр, вектор, матрица или многомерный массив.

Эллиптическая функция Якоби dn, возвращаемая как скаляр, вектор, матрица или многомерный массив.

Подробнее

свернуть все

Эллиптические функции Якоби

Эллиптические функции Якоби определяются в терминах интеграла

u=∫0ϕdθ1−msin2θ.

Тогда

sn (u)  =sinϕ, cn (u)  =cosϕ, dn (u) =1−msin2ϕ.

Некоторые определения эллиптических функций используют эллиптический модуль k или модульный угол α вместо параметра m. Они связаны

k2 = m = sin2a.

Эллиптические функции Якоби подчиняются многим математическим тождествам. Хороший образец см. в разделе [1].

Алгоритмы

ellipj вычисляет эллиптические функции Якоби методом арифметико-геометрического среднего [1]. Начинается с триплета чисел

a0 =  1, b0 =  1 m, c0 = m.

ellipj вычисляет последовательные итерации с использованием

ai = 12 (ai 1 + bi 1) bi = (ai 1bi 1) 12ci = 12 (ai − 1 − bi − 1).

Затем вычисляет амплитуды в радианах с помощью

грех (2ϕn−1−ϕn) =cnansin (ϕn),

быть осторожным, чтобы правильно развернуть фазы. Эллиптические функции Якобиана тогда просто

sn (u) = sinsystem0cn (u) = cosü 0dn (u) =1−m⋅sn (u) 2.

Ссылки

[1] Абрамовиц, М. и И. А. Стегун, Справочник математических функций, Dover Publications, 1965, 17.6.

См. также

Представлен до R2006a