Module: Proj

Defined in:
lib/proj.rb,
lib/api/proj.rb,
lib/proj/crs.rb,
lib/proj/area.rb,
lib/proj/grid.rb,
lib/proj/unit.rb,
lib/proj/datum.rb,
lib/proj/error.rb,
lib/proj/bounds.rb,
lib/api/proj_ffi.rb,
lib/proj/context.rb,
lib/proj/options.rb,
lib/proj/session.rb,
lib/proj/strings.rb,
lib/proj/bounds3d.rb,
lib/proj/crs_info.rb,
lib/proj/database.rb,
lib/proj/axis_info.rb,
lib/proj/ellipsoid.rb,
lib/proj/grid_info.rb,
lib/proj/operation.rb,
lib/proj/parameter.rb,
lib/proj/pj_object.rb,
lib/proj/conversion.rb,
lib/proj/coordinate.rb,
lib/proj/grid_cache.rb,
lib/proj/parameters.rb,
lib/proj/pj_objects.rb,
lib/proj/projection.rb,
lib/api/proj_version.rb,
lib/proj/datum_ensemble.rb,
lib/proj/prime_meridian.rb,
lib/proj/transformation.rb,
lib/api/proj_experimental.rb,
lib/proj/coordinate_system.rb,
lib/proj/file_api_callbacks.rb,
lib/proj/coordinate_metadata.rb,
lib/proj/pj_axis_description.rb,
lib/proj/pj_param_description.rb,
lib/proj/network_api_callbacks.rb,
lib/proj/operation_factory_context.rb,
lib/proj/coordinate_operation_mixin.rb

Defined Under Namespace

Modules: Api, CoordinateOperationMixin, FileApiCallbacks, NetworkApiCallbacks, Projection Classes: Area, AxisInfo, Bounds, Bounds3d, CelestialBody, Context, Conversion, Coordinate, CoordinateMetadata, CoordinateSystem, Crs, CrsInfo, Database, Datum, DatumEnsemble, Ellipsoid, Error, Grid, GridCache, GridInfo, Operation, OperationFactoryContext, Options, Param, Parameter, Parameters, PjObject, PjObjects, PrimeMeridian, Session, Strings, Transformation, Unit

Class Method Summary collapse

Class Method Details

.degrees_minutes_seconds_to_radians(value) ⇒ Float

Convert string of degrees, minutes and seconds to radians.

see proj.org/development/reference/functions.html#c.proj_dmstor proj_dmstor

Parameters:

  • value (String) —

    Value to be converted to radians

Returns:

  • (Float) 


112
113
114
115
 
# File 'lib/proj.rb', line 112

def self.degrees_minutes_seconds_to_radians(value)
  ptr = FFI::MemoryPointer.new(:string)
  Api.proj_dmstor(value, ptr)
end

.degrees_to_radians(value) ⇒ Float

Converts degrees to radians

see proj.org/development/reference/functions.html#c.proj_torad proj_torad

Parameters:

  • value (Float) —

    Value in degrees to convert

Returns:

  • (Float) 


90
91
92
 
# File 'lib/proj.rb', line 90

def self.degrees_to_radians(value)
  Api.proj_torad(value)
end

.info ⇒ PJ_INFO

Returns information about the Proj library

Returns:

  • (PJ_INFO)

See Also:



50
51
52
 
# File 'lib/proj.rb', line 50

def self.info
  Api.proj_info
end

.init_file_info(file_name) ⇒ PJ_INIT_INFO

Return information about the specific init file

Parameters:

  • file_name (String) —

    The name of the init file (not the path)

Returns:

  • (PJ_INIT_INFO)

See Also:



79
80
81
 
# File 'lib/proj.rb', line 79

def self.init_file_info(file_name)
  Api.proj_init_info(file_name)
end

.radians_to_degrees(value) ⇒ Float

Converts radians degrees

see proj.org/development/reference/functions.html#c.proj_todeg proj_todeg

Parameters:

  • value (Float) —

    Value in radians to convert

Returns:

  • (Float) 


101
102
103
 
# File 'lib/proj.rb', line 101

def self.radians_to_degrees(value)
  Api.proj_todeg(value)
end

.radians_to_degrees_minutes_seconds(value, positive = 'N', negative = 'S') ⇒ String

Convert radians to a string representation of degrees, minutes and seconds

Parameters:

  • value (Float) —

    Value to be converted in radians

  • positive (String) (defaults to: 'N') —

    Character denoting positive direction, typically ‘N’ or ‘E’. Default ‘N’

  • negative (String) (defaults to: 'S') —

    Character denoting negative direction, typically ‘S’ or ‘W’. Default ‘S’

Returns:

  • (String)

See Also:



127
128
129
130
131
132
133
134
135
 
# File 'lib/proj.rb', line 127

def self.radians_to_degrees_minutes_seconds(value, positive='N', negative='S')
  ptr = FFI::MemoryPointer.new(:char, 100)
  if Api::PROJ_VERSION < Gem::Version.new('9.2.0')
    Api.proj_rtodms(ptr, value, positive.ord, negative.ord)
  else
    Api.proj_rtodms2(ptr, ptr.size, value, positive.ord, negative.ord)
  end
  ptr.read_string_to_null
end

.search_paths ⇒ Array<String>

Returns default search paths

Returns:

  • (Array<String>) —

    List of search paths

See Also:



68
69
70
 
# File 'lib/proj.rb', line 68

def self.search_paths
  self.info[:searchpath].split(";")
end

.version ⇒ String

Returns the Proj version

Returns:

  • (String)

See Also:



59
60
61
 
# File 'lib/proj.rb', line 59

def self.version
  self.info[:version]
end