rtsIDr (1158390), страница 16
Текст из файла (страница 16)
Один из массивов (но не оба) может быть не распределённым, а обычным, размноженным по всем процессорам, массивом с типом элементов, совпадающим с типом элементов распределённого массива (если определяющий его указатель не является указателем на заголовок распределённого массива). «Обычный» массив считается одномерным, элементы его полагаются расположенными в памяти непрерывно, а параметры, задающие его индексы для копирования, игнорируются.
Если один из массивов не является распределённым, то способ копирования определяется значением *CopyRegimPtr:
-
при нулевом значении *CopyRegimPtr «обычный» массив считается размещённым на всех процессорах текущей процессорной системы;
-
положительное значение *CopyRegimPtr означает, что «обычный» массив предполагается размещённым только на процессоре ввода/вывода;
-
отрицательное значение *CopyRegimPtr (допустимо только для читаемого «обычного» массива) устанавливает режим росписи распределённого массива, определённого параметром ToArrayHeader, элементом, адрес которого задан параметром FromArrayHeader.
Если оба массива не являются распределёнными, то копирование не производится.
Если оба массива являются распределёнными, то они могут иметь различные размерности, размеры по каждому измерению, могут быть по-разному распределены, но должны иметь совпадающий тип элементов.
Как читаемый распределённый массив, так и записываемый должны быть отображены в процессорные системы, каждый элемент которых обязан принадлежать текущей процессорной системе.
Функция возвращает число скопированных элементов.
13.3Асинхронное копирование распределенных массивов
| long arwelm_( | long | FromArrayHeader[], |
| long arwelf_( | long | FromArrayHeader[], |
| long acopel_( | long | FromArrayHeader[], |
| long aelmcp_( | long | FromArrayHeader[], |
| long aarrcp_( | long | FromArrayHeader[], |
Описанные выше функции arwelm_ , arwelf_ , acopel_ , aelmcp_ и aarrcp_ осуществляют запуск операций копирования, выполняемых функциями rwelm_, rwelmf_, copelm_, elmcpy_, и arrcpy_ . Все параметры рассматриваемых функций, кроме последнего, аналогичны одноименным параметрам их синхронных аналогов. Последний параметр, CopyFlagPtr, является указателем на флаг завершения запущенной операции копирования.
Ожидание завершения копирования осуществляется с помощью функции
long waitcp_ (AddrType *CopyFlagPtr);
*CopyFlagPtr флаг завершения операции копирования, заданный при её запуске.
Возвращается нулевое значение.
13.4Доступ к элементам локальной части распределенного массива
Пусть n размерность распределённого массива. Тогда его заголовок, задаваемый при обращении к функции crtda_ c нулевым значением параметра *ExtHdrSignPtr, может быть объявлен, например, как
long ArrayHeader[n+1]; /* стандартный заголовок */
Пусть также базовый указатель, соответствующий типу элементов распределённого массива, есть BasePtr. Тогда обращение к элементу локальной части распределённого массива, определённому индексным вектором (I1,...,In), осуществляется по линейному индексу следующим образом:
| | n-1 |
Для языка C п ри обращении к функции crtda_ значение базового указателя можно задавать равным NULL. Тогда доступ к элементу локальной части распределённого массива можно произвести разименованно:
| | n-1 |
где Type тип элементов распределённого массива.
Коэффициенты ArrayHeader[1], ... ,ArrayHeader[n-1] и адресная константа ArrayHeader[n] вычисляются системой поддержки при выполнении функций выравнивания массива align_ и realn_ следующим образом.
Пусть:
| Ii,нач | | начальное значение индекса локальной части распределённого массива по измерению i; |
| Ii,кон | | конечное значение индекса локальной части распределённого массива по измерению i; |
| LWi | | ширина нижней границы распределённого массива для измерения i; |
| HWi | | ширина верхней границы распределённого массива для измерения i; |
| ArrayPtr | | указатель на локальную часть массива (размещённую в памяти вместе с граничными элементами ); |
| TypeSize | | размер в байтах одного элемента распределённого массива. |
Тогда:
| | n |
| | n-1 |
| ArrayHeader[n] = { | ArrayHeader[n] ( (long)ArrayPtr (long)BasePtr )/TypeSize | при BasePtr ≠ NULL, при BasePtr = NULL. |
При обращении к функции crtda_ с ненулевым значением параметра *ExtHdrSignPtr заголовок распределённого массива может быть статически задан как
long ArrayHeader[2*n+2]; /* расширенный заголовок */
Первые (n+1) слов расширенного заголовка совпадают с рассмотренным выше стандартным заголовком. Слова от (n+2)-го до (2*n+1)-го должны быть заданы программой пользователя до размещения массива в памяти с помощью функции align_ (malign) (предполагается, что в этих словах задаются нижние значения индексов распределённых массивов, используемых в Фортране). (n+1)-е слово расширенного заголовка вычисляется системой поддержки при отображении или переотображении массива в процессорную систему как
| | n i=2 |
Отметим, что система поддержки при выполнении функций align_ и realn_ размещает в памяти локальную часть распределённого массива таким образом, чтобы разность (ArrayPtr BasePtr) была кратна TypeSize.
Доступ к элементам локальной части распределённого массива осуществляется либо непосредственно по его заголовку и базовому указателю, либо, что менее эффективно, с помощью рассмотренных ниже функций rlocel_ , wlocel_ и clocel_ .
13.4.1Опрос принадлежности элемента распределенного массива его локальной части
| long tstelm_( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| IndexArray | | массив, i-й элемент которого содержит значение индекса элемента распределённого массива по его (i+1)-му измерению. |
Число задаваемых индексов должно быть равно размерности распределённого массива.
Возвращается ненулевое значение, если указанный элемент принадлежит локальной части заданного распределённого массива, и нулевое – в противном случае.
13.4.2Опрос начальных и конечных значений индексов локальной части распределенного массива
| long locind_( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| InitIndexArray | | массив, в i-й элемент которого будет возвращено начальное значение индекса локальной части массива по (i+1)-му измерению. |
| LastIndexArray | | массив, в i-й элемент которого будет возвращено конечное значение индекса локальной части массива по (i+1)-му измерению. |
Длины массивов InitIndexArray и LastIndexArray должны быть равны размерности распределённого массива.
Возвращается ненулевое значение, если заданный массив имеет локальную часть, и нулевое в противном случае. Для массива, не имеющего локальной части, содержимое массивов InitIndexArray и LastIndexArray не меняется.
13.4.3Чтение элемента локальной части распределенного массива
| long rlocel_( | long | ArrayHeader[], |
| ArrayHeader | | заголовок распределённого массива. |
| IndexArray | | массив, i-й элемент которого содержит значение индекса читаемого элемента по (i+1)-му измерению распределённого массива. |
| BufferPtr | | указатель на область памяти, в которую будет записано содержимое прочитанного элемента. |
Функция может быть успешно выполнена только тем процессором, в памяти которого размещён заданный элемент.
Возвращается длина элемента распределённого массива в байтах (число прочитанных байтов).
13.4.4Присвоение значения элементу локальной части распределенного массива
| long wlocel_( | void | *BufferPtr, |
| ArrayHeader | | заголовок распределённого массива. |
| IndexArray | | массив, i-й элемент которого содержит значение индекса модифицируемого элемента по (i+1)-му измерению распределённого массива. |
| BufferPtr | | указатель на область памяти, в которой содержится присваиваемое значение. |
Функция может быть успешно выполнена только тем процессором, в памяти которого размещён заданный элемент.
Возвращается длина элемента распределённого массива в байтах.
13.4.5Копирование элемента локальной части одного распределенного массива в элемент локальной части другого распределенного массива
| long clocel_( | long | FromArrayHeader[], |
| FromArrayHeader | | заголовок читаемого распределённого массива. |
| FromIndexArray | | массив, i-й элемент которого содержит значение индекса читаемого элемента по (i+1)-му измерению. |
| ToArrayHeader | | заголовок распределённого массива, в элемент которого произведена запись. |
| ToIndexArray | | массив, j-й элемент которого содержит значение индекса модифицируемого элемента по (j+1)-му измерению. |
Функция может быть успешно выполнена лишь тем процессором, в памяти которого размещены читаемый и записываемый элементы. Типы читаемого и записываемого элементов должны совпадать.
Возвращается число скопированных байтов.
13.4.6Опрос адреса элемента локальной части распределенного массива
| char *GetLocElmAddr ( | long | ArrayHeader[], |















