Determina el rango del proceso en el comunicador cartesiano.
#include <mpi.h> int MPI_Cart_rank(MPI_Comm comm, int *coords, int *rank)
#include <mpi.h> int Cartcomm::Get_cart_rank(const int coords[]) const
| comm | Comunicador con topología cartesiana. |
| coords | Array de enteros (de tamaño ndims, que fue definido con la llamada MPI_Cart_create) especifica las coordenadas cartesianas del proceso. |
| rank | Rango del proceso. |
Para cada proceso del comunicador cartesiano, la función MPI_Cart_rank traduce las coordenadas lógicas de un proceso a su rango. Para la dimensión i con periodicidad = true, si la coordenada i esta fuera del rango, coords(i) < 0 o coords(i) >= dims(i), se cambian automaticamente dentro del rango 0 =< coords(i) < dims(i). Si esta fuera de rango y la dimensión no es periódica ocurre un error.
| MPI_SUCCESS | No ha habido error, la función se ha completado satisfactoriamente. |
| MPI_ERR_TOPOLOGY | Topología no válida. No hay un topología asociada a este comunicador. |
| MPI_ERR_RANK | Rango (rank) de origen o de destino no válido. El valor debe estar comprendido entre cero y el número de procesos del comunicador menos uno. El rango en una función de recibir (como MPI_Recv) puede tomar el valor de MPI_ANY_SOURCE. |
| MPI_ERR_ARG | Valor de argumento no válido. |