Editar

TransformationOptions

Espacio de nombres: Digi21.CoordinateSystems
Ensamblado: Digi21.CoordinateSystems

Opciones de CoordinateTransformation.Create.

public sealed class TransformationOptions

Entre dos sistemas de referencia de coordenadas la base de datos de EPSG puede tener varias operaciones; por ejemplo, de ED50 a ETRS89 tiene quince, una por país o región y con exactitudes de 5 cm a 5 m. Y entre dos sistemas verticales puede no tener ninguna. Estas opciones indican qué hacer en los dos casos.

Propiedades

Propiedad Descripción
SelectCoordinateOperation SelectOperation Delegado que elige la operación cuando hay varias. Si vale null y hay varias, Create lanza TransformationNotFoundException.
CreateVerticalTransformation CreateVerticalTransformation Delegado que crea la transformación vertical cuando la base de datos de EPSG no tiene ninguna, o null.

Propiedades estáticas

Cada lectura de estas propiedades devuelve una instancia nueva, así que se pueden modificar sin afectar a otras llamadas.

BestAccuracy

Opciones sin interfaz, y las que usa Create cuando no recibe opciones:

  1. Si el usuario de Digi3D.AI marcó en el cuadro de diálogo de selección que se use siempre la misma operación para esos dos sistemas, se elige esa.
  2. Si no, se elige la operación de mejor exactitud (el valor de Accuracy más bajo; una operación sin exactitud va la última).
  3. Si la operación elegida no se puede construir, por ejemplo porque falta el archivo de la rejilla NTv2, se descarta y se elige la siguiente.

La transformación vertical es la que el usuario guardó para esos dos sistemas en el cuadro de diálogo de Digi3D.AI, si la hay.

Interactive

Opciones que preguntan al usuario con los cuadros de diálogo de Digi3D.AI: la elección de operación y el desplazamiento vertical entre dos sistemas sin transformación. Si el usuario marcó que se use siempre la misma elección, el cuadro de diálogo no aparece.

Solo se pueden usar desde el hilo principal de Digi3D.AI; desde otro hilo, Create lanza InvalidOperationException. En una aplicación de consola no hay hilo principal de Digi3D.AI y los cuadros de diálogo se muestran desde el hilo que llama. Si el usuario cancela un cuadro de diálogo, Create lanza CoordinateSystemException.

Delegados

SelectCoordinateOperation

public delegate int SelectCoordinateOperation(string sourceName, string targetName, IReadOnlyList<CoordinateOperation> operations);

Recibe los nombres de los dos sistemas entre los que hay varias operaciones (pueden ser los sistemas geográficos en los que se basan los que se pasaron a Create) y la lista de operaciones. Devuelve el código (Code) de la operación elegida, que tiene que ser uno de los de la lista.

CreateVerticalTransformation

public delegate VerticalTransformation CreateVerticalTransformation(string sourceName, string targetName);

Recibe los nombres de los dos sistemas verticales (o del sistema geográfico 3D y el vertical) y devuelve la transformación vertical, o null si no hay ninguna; en ese caso Create lanza TransformationNotFoundException.

CoordinateOperation

Operación de coordenadas de la base de datos de EPSG.

Propiedad Descripción
int Code Código EPSG de la operación.
string Name Nombre, por ejemplo ED50 to ETRS89 (16).
string Type Tipo de operación (transformation).
string Version Versión, por ejemplo IGN-Esp v3 pen, o null.
int? Variant Variante, o null.
string Scope Ámbito de uso, o null.
double? Accuracy Exactitud en metros, o null.
int MethodCode Código EPSG del método, por ejemplo 9615 (NTv2).
string Remarks Observaciones, o null.
string InformationSource Fuente de información, o null.

VerticalTransformation

Transformación entre dos sistemas verticales.

Método Descripción
static VerticalTransformation Offset(double meters) Transformación que suma a la altitud un desplazamiento constante en metros.

Ejemplo

Elegir siempre la operación del IGN y, si no hay transformación vertical, sumar 10 metros:

var opciones = new TransformationOptions
{
    SelectOperation = (origen, destino, operaciones) =>
        operaciones.FirstOrDefault(o => o.Version?.StartsWith("IGN-Esp") == true)?.Code ?? operaciones[0].Code,
    CreateVerticalTransformation = (origen, destino) => VerticalTransformation.Offset(10.0)
};

using var transformación = CoordinateTransformation.Create(
    CoordinateSystem.FromEpsg(23030),
    CoordinateSystem.FromEpsg(25830),
    opciones);