proj4rb 3.0.0 → 4.0.0

data/lib/proj/projection.rb

@@ -1,207 +1,698 @@
-# encoding: UTF-8
-
-module Proj
-  # @deprecated This class is *DEPRECATED.* It will be removed when Proj 7 is released and removes the
-  #   underlying API's this class uses. Code should be ported to use Crs and Transformation objects.
-  class Projection
-    def self.parse(value)
-      case value
-        when Array
-         value
-        when String
-         value.strip.split(' ')
-        when Hash
-         array = []
-         value.each_pair do |key, value|
-           key = "+#{key}"
-           array << (value.nil? ? key : "#{key}=#{value}")
-         end
-         array
-        when Projection
-         value.getDef.split(' ')
-        else
-         raise ArgumentError, "Unknown type #{value.class} for projection definition"
-      end
-    end
-
-    def self.finalize(pointer)
-      proc do
-        Api.pj_free(pointer)
-      end
-    end
-
-    # Projection classes are created using Proj4 strings which consist of a number of parameters.
-    # For more information please see the +opt arguments section at https://proj.org/apps/proj.html.
-    #
-    # @param value [string, array, hash] Parameters can be specified as strings, arrays or hashes.
-    #
-    # @example
-    #   proj = Projection.new("+proj=utm +zone=21 +units=m")
-    #   proj = Projection.new ["+proj=utm", "+zone=21", "+units=m"]
-    #   proj = Projection.new("proj" => "utm", "zone" => "21", "units" => "m")
-    #
-    # With all variants the plus sign in front of the keys is optional.
-    def initialize(value)
-      params = self.class.parse(value)
-      p_params = FFI::MemoryPointer.new(:pointer, params.length)
-      params.each_with_index do |param, i|
-        p_param = FFI::MemoryPointer.from_string(param)
-        p_params[i].write_pointer(p_param)
-      end
-
-      @pointer = Api.pj_init(params.count, p_params)
-      self.check_error
-
-      ObjectSpace.define_finalizer(self, self.class.finalize(@pointer))
-    end
-
-    def check_error
-      ptr = Api.pj_get_errno_ref
-      errno = ptr.read_int
-      if errno != 0
-        # If we don't reset the error code it hangs around. This doesn't seem documented anyplace?
-        ptr.write_int(0)
-        Error.check(errno)
-      end
-    end
-
-
-    def to_ptr
-      @pointer
-    end
-
-    # Returns projection definitions
-    #
-    # @return [String]
-    def getDef
-      Api.pj_get_def(self, 0)
-    end
-
-    # Returns if this is a geocentric projection
-    #
-    # @return [Boolean]
-    def isGeocent?
-      Api::pj_is_geocent(self)
-    end
-    alias :isGeocentric? :isGeocent?
-
-    # Returns if this is a lat/long projection
-    #
-    # @return [Boolean]
-    def isLatLong?
-      Api::pj_is_latlong(self)
-    end
-
-    # Get the ID of this projection.
-    #
-    # @return [String]
-    def projection
-      getDef =~ /\+proj=(.+?) / ?  $1 : nil
-    end
-
-    # Get the ID of the datum used in this projection.
-    #
-    # @return [String]
-    def datum
-      getDef =~ /\+datum=(.+?) / ? $1 : nil
-    end
-
-    # Get definition of projection in typical inspect format (#<Proj::Projection +init=... +proj=... ...>).
-    #
-    # @return [String]
-    def to_s
-      "#<#{self.class.name}#{getDef}>"
-    end
-
-    # Forward projection of a point. Returns a copy of the point object with coordinates projected.
-    #
-    # @param point [Point] in radians
-    # @return [Point] in cartesian coordinates
-    def forward(point)
-      struct = Api.pj_fwd(point, self)
-      self.check_error
-      Point.from_pointer(struct)
-    end
-
-    # Convenience function for calculating a forward projection with degrees instead of radians.
-    #
-    # @param point [Point] in degrees
-    # @return [Point] in cartesian coordinates
-    def forwardDeg(point)
-      forward(point.to_radians)
-    end
-
-    # Projects all points in a collection.
-    #
-    # @param collection [Enumerable<Point>] Points specified in radians
-    # @return [Enumerable<Point>] Points specified in cartesian coordinates
-    def forward_all(collection)
-      collection.map do |point|
-        forward(point)
-      end
-    end
-
-    # Inverse projection of a point. Returns a copy of the point object with coordinates projected.
-    #
-    # @param point [Point] in cartesian coordinates
-    # @return [Point] in radians
-    def inverse(point)
-      struct = Api.pj_inv(point, self)
-      self.check_error
-      Point.from_pointer(struct)
-    end
-
-    # Convenience function for calculating an inverse projection with the result in degrees instead of radians.
-    #
-    # @param point [Point] in cartesian coordinates
-    # @return [Point] in degrees
-    def inverseDeg(point)
-      result = inverse(point)
-      result.to_degrees
-    end
-
-    # Inverse projection of all points in a collection.
-    #
-    # @param collection [Enumerable<Point>] Points specified in cartesian coordinates
-    # @return [Enumerable<Point>] Points specified in radians
-    def inverse_all(collection)
-      collection.map do |point|
-        inverse(point)
-      end
-    end
-
-    # Transforms a point from one projection to another.
-    #
-    # @param other [Projection]
-    # @param point [Point]
-    # @return [Point]
-    def transform(other, point)
-      p_x = FFI::MemoryPointer.new(:double, 1)
-      p_x.write_double(point.x)
-
-      p_y = FFI::MemoryPointer.new(:double, 1)
-      p_y.write_double(point.y)
-
-      p_z = FFI::MemoryPointer.new(:double, 1)
-      p_z.write_double(0)
-
-      Api.pj_transform(self, other, 1, 1, p_x, p_y, p_z)
-      self.check_error
-
-      Point.new(p_x.read_double, p_y.read_double)
-    end
-
-    # Transforms all points in a collection from one projection to
-    # another. The +collection+ object must implement the +each+,
-    # +clear+, and << methods (just like an Array) for this to work.
-    #
-    # @param other [Projection]
-    # @param collection [Enumerable, Point]
-    # @return [Enumerable, Point]
-    def transform_all(other, collection)
-      collection.map do |point|
-        transform(other, point)
-      end
-    end
-  end
-end
+# encoding: UTF-8
+require 'stringio'
+
+module Proj
+  # Projections are coordinate operations that are conversions. For more information about each
+  # projection @see https://proj.org/operations/projections/index.html
+  module Projection
+    def self.utm(context, zone:, north: true)
+      ptr = Api.proj_create_conversion_utm(context, zone, north ? 1 : 0)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.transverse_mercator(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_transverse_mercator(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.gauss_schreiber_transverse_mercator(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_gauss_schreiber_transverse_mercator(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.transverse_mercator_south_oriented(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_transverse_mercator_south_oriented(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.two_point_equidistant(context, latitude_first_point:, longitude_first_point:, latitude_second_point:, longitude_secon_point:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_two_point_equidistant(context, latitude_first_point, longitude_first_point, latitude_second_point, longitude_secon_point, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.tunisia_mapping_grid(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_tunisia_mapping_grid(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.tunisia_mining_grid(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_tunisia_mining_grid(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.albers_equal_area(context, latitude_false_origin:, longitude_false_origin:, latitude_first_parallel:, latitude_second_parallel:, easting_false_origin:, northing_false_origin:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_albers_equal_area(context, latitude_false_origin, longitude_false_origin, latitude_first_parallel, latitude_second_parallel, easting_false_origin, northing_false_origin, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_conic_conformal_1sp(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_conic_conformal_1sp(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_conic_conformal_2sp(context, latitude_false_origin:, longitude_false_origin:, latitude_first_parallel:, latitude_second_parallel:, easting_false_origin:, northing_false_origin:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_conic_conformal_2sp(context, latitude_false_origin, longitude_false_origin, latitude_first_parallel, latitude_second_parallel, easting_false_origin, northing_false_origin, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_conic_conformal_2sp_michigan(context, latitude_false_origin:, longitude_false_origin:, latitude_first_parallel:, latitude_second_parallel:, easting_false_origin:, northing_false_origin:, ellipsoid_scaling_factor:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_conic_conformal_2sp_michigan(context, latitude_false_origin, longitude_false_origin, latitude_first_parallel, latitude_second_parallel, easting_false_origin, northing_false_origin, ellipsoid_scaling_factor, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_conic_conformal_2sp_belgium(context, latitude_false_origin:, longitude_false_origin:, latitude_first_parallel:, latitude_second_parallel:, easting_false_origin:, northing_false_origin:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_conic_conformal_2sp_belgium(context, latitude_false_origin, longitude_false_origin, latitude_first_parallel, latitude_second_parallel, easting_false_origin, northing_false_origin, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.azimuthal_equidistant(context, latitude_nat_origin:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_azimuthal_equidistant(context, latitude_nat_origin, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.guam_projection(context, latitude_nat_origin:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_guam_projection(context, latitude_nat_origin, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.bonne(context, latitude_nat_origin:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_bonne(context, latitude_nat_origin, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_cylindrical_equal_area_spherical(context, latitude_first_parallel:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_cylindrical_equal_area_spherical(context, latitude_first_parallel, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_cylindrical_equal_area(context, latitude_first_parallel:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_cylindrical_equal_area(context, latitude_first_parallel, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.cassini_soldner(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_cassini_soldner(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.equidistant_conic(context, center_lat:, center_long:, latitude_first_parallel:, latitude_second_parallel:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_equidistant_conic(context, center_lat, center_long, latitude_first_parallel, latitude_second_parallel, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_i(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_i(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_ii(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_ii(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_iii(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_iii(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_iv(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_iv(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_v(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_v(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.eckert_vi(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_eckert_vi(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.equidistant_cylindrical(context, latitude_first_parallel:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_equidistant_cylindrical(context, latitude_first_parallel, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.equidistant_cylindrical_spherical(context, latitude_first_parallel:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_equidistant_cylindrical_spherical(context, latitude_first_parallel, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.gall(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_gall(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.goode_homolosine(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_goode_homolosine(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.interrupted_goode_homolosine(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_interrupted_goode_homolosine(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.geostationary_satellite_sweep_x(context, center_long:, height:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_geostationary_satellite_sweep_x(context, center_long, height, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.geostationary_satellite_sweep_y(context, center_long:, height:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_geostationary_satellite_sweep_y(context, center_long, height, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.gnomonic(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_gnomonic(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.hotine_oblique_mercator_variant_a(context, latitude_projection_centre:, longitude_projection_centre:, azimuth_initial_line:, angle_from_rectified_to_skrew_grid:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_hotine_oblique_mercator_variant_a(context, latitude_projection_centre, longitude_projection_centre, azimuth_initial_line, angle_from_rectified_to_skrew_grid, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.hotine_oblique_mercator_variant_b(context, latitude_projection_centre:, longitude_projection_centre:, azimuth_initial_line:, angle_from_rectified_to_skrew_grid:, scale:, easting_projection_centre:, northing_projection_centre:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_hotine_oblique_mercator_variant_b(context, latitude_projection_centre, longitude_projection_centre, azimuth_initial_line, angle_from_rectified_to_skrew_grid, scale, easting_projection_centre, northing_projection_centre, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.hotine_oblique_mercator_two_point_natural_origin(context, latitude_projection_centre:, latitude_point1:, longitude_point1:, latitude_point2:, longitude_point2:, scale:, easting_projection_centre:, northing_projection_centre:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_hotine_oblique_mercator_two_point_natural_origin(context, latitude_projection_centre, latitude_point1, longitude_point1, latitude_point2, longitude_point2, scale, easting_projection_centre, northing_projection_centre, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.laborde_oblique_mercator(context, latitude_projection_centre:, longitude_projection_centre:, azimuth_initial_line:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_laborde_oblique_mercator(context, latitude_projection_centre, longitude_projection_centre, azimuth_initial_line, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.international_map_world_polyconic(context, center_long:, latitude_first_parallel:, latitude_second_parallel:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_international_map_world_polyconic(context, center_long, latitude_first_parallel, latitude_second_parallel, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.krovak_north_oriented(context, latitude_projection_centre:, longitude_of_origin:, colatitude_cone_axis:, latitude_pseudo_standard_parallel:, scale_factor_pseudo_standard_parallel:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_krovak_north_oriented(context, latitude_projection_centre, longitude_of_origin, colatitude_cone_axis, latitude_pseudo_standard_parallel, scale_factor_pseudo_standard_parallel, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.krovak(context, latitude_projection_centre:, longitude_of_origin:, colatitude_cone_axis:, latitude_pseudo_standard_parallel:, scale_factor_pseudo_standard_parallel:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_krovak(context, latitude_projection_centre, longitude_of_origin, colatitude_cone_axis, latitude_pseudo_standard_parallel, scale_factor_pseudo_standard_parallel, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.lambert_azimuthal_equal_area(context, latitude_nat_origin:, longitude_nat_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_lambert_azimuthal_equal_area(context, latitude_nat_origin, longitude_nat_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.miller_cylindrical(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_miller_cylindrical(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.mercator_variant_a(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_mercator_variant_a(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.mercator_variant_b(context, latitude_first_parallel:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_mercator_variant_b(context, latitude_first_parallel, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.popular_visualisation_pseudo_mercator(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_popular_visualisation_pseudo_mercator(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.mollweide(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_mollweide(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.new_zealand_mapping_grid(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_new_zealand_mapping_grid(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.oblique_stereographic(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_oblique_stereographic(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.orthographic(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_orthographic(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.american_polyconic(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_american_polyconic(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.polar_stereographic_variant_a(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_polar_stereographic_variant_a(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.polar_stereographic_variant_b(context, latitude_standard_parallel:, longitude_of_origin:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_polar_stereographic_variant_b(context, latitude_standard_parallel, longitude_of_origin, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.robinson(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_robinson(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.sinusoidal(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_sinusoidal(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.stereographic(context, center_lat:, center_long:, scale:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_stereographic(context, center_lat, center_long, scale, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.van_der_grinten(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_van_der_grinten(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_i(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_i(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_ii(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_ii(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_iii(context, latitude_true_scale:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_iii(context, latitude_true_scale, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_iv(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_iv(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_v(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_v(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_vi(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_vi(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.wagner_vii(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_wagner_vii(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.quadrilateralized_spherical_cube(context, center_lat:, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_quadrilateralized_spherical_cube(context, center_lat, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.spherical_cross_track_height(context, peg_point_lat:, peg_point_long:, peg_point_heading:, peg_point_height:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_spherical_cross_track_height(context, peg_point_lat, peg_point_long, peg_point_heading, peg_point_height, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.equal_earth(context, center_long:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_equal_earth(context, center_long, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.vertical_perspective(context, topo_origin_lat:, topo_origin_long:, topo_origin_height:, view_point_height:, false_easting:, false_northing:, ang_unit_name:, ang_unit_conv_factor:, linear_unit_name:, linear_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_vertical_perspective(context, topo_origin_lat, topo_origin_long, topo_origin_height, view_point_height, false_easting, false_northing, ang_unit_name, ang_unit_conv_factor, linear_unit_name, linear_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.pole_rotation_grib_convention(context, south_pole_lat_in_unrotated_crs:, south_pole_long_in_unrotated_crs:, axis_rotation:, ang_unit_name:, ang_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_pole_rotation_grib_convention(context, south_pole_lat_in_unrotated_crs, south_pole_long_in_unrotated_crs, axis_rotation, ang_unit_name, ang_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+
+    def self.pole_rotation_netcdf_cf_convention(context, grid_north_pole_latitude:, grid_north_pole_longitude:, north_pole_grid_longitude:, ang_unit_name:, ang_unit_conv_factor:)
+      ptr = Api.proj_create_conversion_pole_rotation_netcdf_cf_convention(context, grid_north_pole_latitude, grid_north_pole_longitude, north_pole_grid_longitude, ang_unit_name, ang_unit_conv_factor)
+
+      if ptr.null?
+        Error.check_context(context)
+      end
+
+      Conversion.create_object(ptr, context)
+    end
+  end
+end