1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
GeoData
=======
.. module:: ezdxf.entities
:noindex:
The `GEODATA`_ entity is associated to the :class:`~ezdxf.layouts.Modelspace`
object. The `GEODATA`_ entity is supported since the DXF version R2000,
but was officially documented the first time in the DXF reference for version
R2009.
======================== =============================================================
Subclass of :class:`ezdxf.entities.DXFObject`
DXF type ``'GEODATA'``
Factory function :meth:`ezdxf.layouts.Modelspace.new_geodata`
Required DXF version R2010 (``'AC1024'``)
======================== =============================================================
.. seealso::
`geodata_setup_local_grid.py <https://github.com/mozman/ezdxf/blob/master/examples/entities/geodata_setup_local_grid.py>`_
.. warning::
Do not instantiate object classes by yourself - always use the provided factory functions!
.. _GEODATA: http://help.autodesk.com/view/OARX/2018/ENU/?guid=GUID-104FE0E2-4801-4AC8-B92C-1DDF5AC7AB64
.. class:: GeoData
.. attribute:: dxf.version
=== =========
1 R2009
2 R2010
=== =========
.. attribute:: dxf.coordinate_type
=== =================================
0 unknown
1 local grid
2 projected grid
3 geographic (latitude/longitude)
=== =================================
.. attribute:: GeoData.dxf.block_record_handle
Handle of host BLOCK_RECORD table entry, in general the :class:`~ezdxf.layouts.Modelspace`.
.. attribute:: dxf.design_point
Reference point in :ref:`WCS` coordinates.
.. attribute:: dxf.reference_point
Reference point in geo coordinates, valid only when coordinate type is `local grid`.
The difference between `dxf.design_point` and `dxf.reference_point` defines the translation
from WCS coordinates to geo-coordinates.
.. attribute:: dxf.north_direction
North direction as 2D vector. Defines the rotation (about the `dxf.design_point`) to transform
from WCS coordinates to geo-coordinates
.. attribute:: dxf.horizontal_unit_scale
Horizontal unit scale, factor which converts horizontal design coordinates to meters by multiplication.
.. attribute:: dxf.vertical_unit_scale
Vertical unit scale, factor which converts vertical design coordinates to meters by multiplication.
.. attribute:: dxf.horizontal_units
Horizontal units (see :class:`~ezdxf.entities.BlockRecord`). Will be 0 (Unitless) if units specified
by horizontal unit scale is not supported by AutoCAD enumeration.
.. attribute:: dxf.vertical_units
Vertical units (see :class:`~ezdxf.entities.BlockRecord`). Will be 0 (Unitless) if units specified by
vertical unit scale is not supported by AutoCAD enumeration.
.. attribute:: dxf.up_direction
Up direction as 3D vector.
.. attribute:: dxf.scale_estimation_method
=== ========================================
1 none
2 user specified scale factor
3 grid scale at reference point
4 prismoidal
=== ========================================
.. attribute:: dxf.sea_level_correction
Bool flag specifying whether to do sea level correction.
.. attribute:: dxf.user_scale_factor
.. attribute:: dxf.sea_level_elevation
.. attribute:: dxf.coordinate_projection_radius
.. attribute:: dxf.geo_rss_tag
.. attribute:: dxf.observation_from_tag
.. attribute:: dxf.observation_to_tag
.. attribute:: dxf.mesh_faces_count
.. attribute:: source_vertices
2D source vertices in the CRS of the GeoData as :class:`~ezdxf.lldxf.packedtags.VertexArray`.
Used together with `target_vertices` to define the transformation from the CRS of the GeoData to WGS84.
.. attribute:: target_vertices
2D target vertices in WGS84 (EPSG:4326) as :class:`~ezdxf.lldxf.packedtags.VertexArray`.
Used together with `source_vertices` to define the transformation from the CRS of the geoData to WGS84.
.. attribute:: faces
List of face definition tuples, each face entry is a 3-tuple of vertex indices (0-based).
.. attribute:: coordinate_system_definition
The coordinate system definition string. Stored as XML. Defines the CRS used by the GeoData.
The EPSG number and other details like the axis-ordering of the CRS is stored.
.. automethod:: get_crs
.. automethod:: get_crs_transformation
.. automethod:: setup_local_grid(*, design_point: UVec, reference_point: UVec, north_direction: UVec = (0, 1), crs: str = EPSG_3395)
|
