################# # CRS CLASSES ################# # first classes for each crs element, from the proj4 common paramter listing # https://trac.osgeo.org/proj/wiki/GenParms # note also that in wkt the names of "PROJECTION", "DATUM", and "SPHEROID" # matter and seem to be interpreted and computed upon, ie they carry meaning # that is commonly understood by programs, so is not explicit in the crs specification. # the paramters below simply modify certain aspects of the proj/datum/spheroids # note that the names in wkt of "PROJCS" and "GEOGCS" seem to be purely # for identifying and branding and can be changed at will. # they do however act as shortcuts, so that proj4 can use +init=... to load # everything automatically # some of these names imply certain combinations of datum and spheroid and paramters. # so in proj4 one simply needs to give that name, but in wkt one needs to spell it all out. # +unit and +to_metre are what makes up 'UNIT["Meter",1.0]' from . import datums from . import directions from . import units ################ def find(paramname, crstype, strict=False): if not strict: paramname = paramname.lower() for itemname,item in globals().items(): if itemname.startswith("_"): continue try: if hasattr(item, crstype): itemname = getattr(item, crstype) if not strict: itemname = itemname.lower() if paramname == itemname: return item except: pass else: return None # NOT CURRENTLY USED, BUT SHOULD BE # FOR NOW ONLY SET AS PURE VALUES INSIDE ELLIPSOID... ####+a Semimajor radius of the ellipsoid axis ##class SemiMajorRadius: ## proj4 = "+a" ## def __init__(self, value): ## pass ## ####+b Semiminor radius of the ellipsoid axis ##class SemiMinorRadius: ## proj4 = "+b" ## def __init__(self, value): ## pass ################# ##+alpha ? Used with Oblique Mercator and possibly a few others class Azimuth: proj4 = "+alpha" esri_wkt = "azimuth" ogc_wkt = "azimuth" geotiff = "AzimuthAngle" def __init__(self, value): self.value = value def to_proj4(self): return "+alpha=%s" % self.value def to_ogc_wkt(self): return 'PARAMETER["Azimuth",%s]' % self.value def to_esri_wkt(self): return 'PARAMETER["Azimuth",%s]' % self.value ##+k Scaling factor (old name) ##+k_0 Scaling factor (new name) class ScalingFactor: proj4 = "+k" ogc_wkt = "scale_factor" def __init__(self, value): self.value = value def to_proj4(self): return "+k_0=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["scale_factor", %s]' %self.value def to_esri_wkt(self): # REALLY?? raise Exception("Paramater not supported by ESRI WKT") def to_geotiff(self): pass #return "ScaleAtNatOrigin" # or ScaleAtCenter? ##+lat_0 Latitude of origin class LatitudeOrigin: proj4 = "+lat_0" ogc_wkt = "latitude_of_origin" esri_wkt = "Latitude_Of_Origin" def __init__(self, value): self.value = value def to_proj4(self): return "+lat_0=%s" %self.value def to_ogc_wkt(self): # SAME AS LATITUDE OF CENTER??? return 'PARAMETER["latitude_of_origin", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Latitude_Of_Origin", %s]' %self.value def to_geotiff(self): pass #return "ProjCenterLat" ##+lat_1 Latitude of first standard parallel class LatitudeFirstStndParallel: proj4 = "+lat_1" ogc_wkt = "standard_parallel_1" esri_wkt = "Standard_Parallel_1" def __init__(self, value): self.value = value def to_proj4(self): return "+lat_1=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["standard_parallel_1", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Standard_Parallel_1", %s]' %self.value def to_geotiff(self): pass #return "StdParallel1" ##+lat_2 Latitude of second standard parallel class LatitudeSecondStndParallel: proj4 = "+lat_2" ogc_wkt = "standard_parallel_2" esri_wkt = "Standard_Parallel_2" def __init__(self, value): self.value = value def to_proj4(self): return "+lat_2=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["standard_parallel_2", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Standard_Parallel_2", %s]' %self.value def to_geotiff(self): pass #return "StdParallel2" ##+lat_ts Latitude of true scale class LatitudeTrueScale: proj4 = "lat_ts" ogc_wkt = "Standard_Parallel_1" esri_wkt = "Standard_Parallel_1" def __init__(self, value): self.value = value def to_proj4(self): return "+lat_ts=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["Standard_Parallel_1", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Standard_Parallel_1", %s]' %self.value def to_geotiff(self): pass #return "ProjStdParallel1" ##+lon_0 Central meridian class CentralMeridian: proj4 = "+lon_0" ogc_wkt = "Central_Meridian" esri_wkt = "Central_Meridian" def __init__(self, value): self.value = value def to_proj4(self): return "+lon_0=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["Central_Meridian", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Central_Meridian", %s]' %self.value def to_geotiff(self): pass #return "ProjCenterLong" ##+lonc ? Longitude used with Oblique Mercator and possibly a few others class LongitudeCenter: proj4 = "+lonc" ogc_wkt = "Longitude_Of_Center" esri_wkt = "Longitude_Of_Center" def __init__(self, value): self.value = value def to_proj4(self): return "+lonc=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["Longitude_Of_Center", %s]' %self.value def to_esri_wkt(self): return 'PARAMETER["Longitude_Of_Center", %s]' %self.value ##+lon_wrap Center longitude to use for wrapping (see below) ##+over Allow longitude output outside -180 to 180 range, disables wrapping (see below) ##+pm Alternate prime meridian (typically a city name, see below) class PrimeMeridian: proj4 = "+pm" ogc_wkt = "PRIMEM" esri_wkt = "PRIMEM" def __init__(self, value): """ Arguments: - **value**: Longitude value relative to Greenwich. """ self.value = value def to_proj4(self): return "+pm=%s" %self.value def to_ogc_wkt(self): return 'PRIMEM["Greenwich", %s]' %self.value def to_esri_wkt(self): return 'PRIMEM["Greenwich", %s]' %self.value ##+zone UTM zone ##+south Denotes southern hemisphere UTM zone ##+towgs84 3 or 7 term datum transform parameters (see below) class DatumShift: proj4 = "+towgs84" ogc_wkt = "TOWGS84" def __init__(self, value): self.value = value def to_proj4(self): return "+towgs84=%s" %",".join((bytes(val) for val in self.value)) def to_ogc_wkt(self): return "TOWGS84[%s]" %",".join((bytes(val) for val in self.value)) def to_esri_wkt(self): raise Exception("Paramater not supported by ESRI WKT") ##+to_meter Multiplier to convert map units to 1.0m class MeterMultiplier: proj4 = "+to_meter" def __init__(self, value): self.value = value def to_proj4(self): return "+to_meter=%s" %self.value def to_ogc_wkt(self): # the stuff that comes after UNITS["meter", ... # must be combined with unittype in a unit class to make wkt return bytes(self.value) def to_esri_wkt(self): return bytes(self.value) ##+units meters, US survey feet, etc. class UnitType: proj4 = "+units" def __init__(self, value): """ Arguments: - **value**: A specific unit type instance, eg Meter(). """ self.value = value def to_proj4(self): return "+units=%s" %self.value.proj4 def to_ogc_wkt(self): # the stuff that comes after UNITS[... # must be combined with metermultiplier in a unit class to make wkt return bytes(self.value.ogc_wkt) def to_esri_wkt(self): return bytes(self.value.esri_wkt) # special... class Unit: ogc_wkt = "UNIT" esri_wkt = "UNIT" def __init__(self, unittype, metermultiplier): self.unittype = unittype self.metermultiplier = metermultiplier def to_proj4(self): if isinstance(self.unittype, units.Unknown): return "%s" % self.metermultiplier.to_proj4() else: return "%s %s" %(self.unittype.to_proj4(), self.metermultiplier.to_proj4()) def to_ogc_wkt(self): return 'UNIT["%s", %s]' %(self.unittype.to_ogc_wkt(), self.metermultiplier.to_ogc_wkt()) def to_esri_wkt(self): return 'UNIT["%s", %s]' %(self.unittype.to_esri_wkt(), self.metermultiplier.to_esri_wkt()) # angular unit class AngularUnit: ogc_wkt = "UNIT" esri_wkt = "UNIT" def __init__(self, unittype, metermultiplier): self.unittype = unittype self.metermultiplier = metermultiplier def to_proj4(self): # cannot be specified in proj4, so just return nothing return "" def to_ogc_wkt(self): return 'UNIT["%s", %s]' %(self.unittype.to_ogc_wkt(), self.metermultiplier.to_ogc_wkt()) def to_esri_wkt(self): return 'UNIT["%s", %s]' %(self.unittype.to_esri_wkt(), self.metermultiplier.to_esri_wkt()) ##+x_0 False easting class FalseEasting: proj4 = "+x_0" esri_wkt = "False_Easting" ogc_wkt = "false_easting" geotiff = "FalseEasting" def __init__(self, value): self.value = value def to_proj4(self): return "+x_0=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["false_easting", %s]' % self.value def to_esri_wkt(self): return 'PARAMETER["False_Easting", %s]' % self.value ##+y_0 False northing class FalseNorthing: proj4 = "+y_0" esri_wkt = "False_Northing" ogc_wkt = "false_northing" geotiff = "FalseNorthing" def __init__(self, value): self.value = value def to_proj4(self): return "+y_0=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["false_northing", %s]' % self.value def to_esri_wkt(self): return 'PARAMETER["False_Northing", %s]' % self.value ##+h Satellite height class SatelliteHeight: proj4 = "+h" ogc_wkt = "satellite_height" esri_wkt = "satellite_height" def __init__(self, value): self.value = value def to_proj4(self): return "+h=%s" %self.value def to_ogc_wkt(self): return 'PARAMETER["satellite_height", %s]' % self.value def to_esri_wkt(self): return 'PARAMETER["satellite_height", %s]' % self.value ##+tilt Tilt angle class TiltAngle: proj4 = "+tilt" def __init__(self, value): self.value = value def to_proj4(self): return "+tilt=%s" %self.value def to_ogc_wkt(self): raise Exception("Parameter not supported by OGC WKT") def to_esri_wkt(self): raise Exception("Parameter not supported by ESRI WKT")