voruby 1.0.1

data/lib/voruby/services/gestalt/footprint.rb

@@ -0,0 +1,95 @@
+require 'voruby/services/loader'
+
+module VORuby
+  module Services
+    module Gestalt
+
+      class FootPrintService
+        attr_reader :driver
+  
+        def initialize(driver, debug=false)
+          @driver = driver
+          @driver.wiredump_dev = $stderr if debug
+        end
+  
+        def self.from_wsdl(wsdl='http://nvogre.phyast.pitt.edu:8080/axis2/services/GestaltService?wsdl', debug=false)
+          return FootPrintService.new(SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver, debug)
+        end
+  
+        def makeCircleMap(ra, dec, radius, multiple_tables=false)
+          ra = [ra] if !ra.is_a?(Array)
+          dec = [dec] if !dec.is_a?(Array)
+          radius = [radius] if !radius.is_a?(Array)
+    
+          params = {}
+          params['in0'] = ra
+          params['in1'] = dec
+          params['in2'] = radius
+          params['in3'] = multiple_tables
+    
+          map_names = @driver.makeCircleMap(params.to_soap_map)['makeCircleMapReturn']
+    
+          map_names = [map_names] if !map_names.is_a?(Array)
+          return map_names
+        end
+  
+        def deleteTables(map_name)
+          params = {}
+          params['in0'] = map_name
+    
+          # Successful deletion is 0 for some reason...
+          return true if @driver.deleteTables(params.to_soap_map)['deleteTablesReturn'] == '0'
+          return false
+        end
+  
+        def deleteAllTables(map_names)
+          responses = []
+          map_names.each do |map_name|
+            responses.push(self.deleteTables(map_name))
+          end
+    
+          return responses
+        end
+  
+        def makePlot(map_names, ramin, ramax, decmin, decmax, fill=false, color=1)
+          params = {}
+          params['in0'] = ramin
+          params['in1'] = ramax
+          params['in2'] = decmin
+          params['in3'] = decmax
+          params['in4'] = fill
+          params['in5'] = color
+          if !map_names.is_a?(Array)
+            params['in6'] = [map_names]
+          else
+            params['in6'] = map_names
+          end
+    
+          return @driver.makePlot(params.to_soap_map)['makePlotReturn']
+        end
+  
+        def self.plot_limits(ra, dec, radius, buffer=1.0)
+          ra = [ra] if !ra.is_a?(Array)
+          dec = [dec] if !dec.is_a?(Array)
+          radius = [radius] if !radius.is_a?(Array)
+    
+          min_ra_ind = ra.index(ra.min)
+          min_ra = ra.min - (radius[min_ra_ind] + buffer)
+          max_ra_ind = ra.index(ra.max)
+          max_ra = ra.max + (radius[max_ra_ind] + buffer)
+    
+          min_dec_ind = dec.index(dec.min)
+          min_dec = dec.min - (radius[min_dec_ind] + buffer)
+          max_dec_ind = dec.index(dec.max)
+          max_dec = dec.max + (radius[max_dec_ind] + buffer)
+    
+          return [min_ra, max_ra, min_dec, max_dec]
+        end
+      end
+
+    end
+  end
+end
+
+
+

data/lib/voruby/services/gestalt/wcs_fixer.rb

@@ -0,0 +1,105 @@
+require 'voruby/services/loader'
+
+module VORuby
+  module Services
+    module Gestalt
+  
+      class WCSFixerException < RuntimeError; end
+      class WCSFixerSoapException < WCSFixerException; end
+
+      class WCSFixerService
+        attr_reader :driver
+  
+        def initialize(driver, debug=false)
+          @driver = driver
+          @driver.wiredump_dev = $stderr if debug
+        end
+  
+        def self.from_wsdl(wsdl='http://nvogre.phyast.pitt.edu:9090/wcs/WcsFixer.asmx?wsdl', debug=false)
+          return WCSFixerService.new(SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver, debug)
+        end
+    
+        # Corrects a FITS image URL with WCS information.
+        # If output_file is specified, the corrected FITS images is retrieved and stored locally,
+        # otherwise its URI is returned.
+        def fixUrl(url, output_file=nil, calibration_db="SDSSDR3", approx_img_offset=5.0, num_objects=50, ellipticity_cut=1.2)
+          params = {'url' => url,
+                    'db' => calibration_db,
+                    'offset' => approx_img_offset,
+                    'numObjects' => num_objects,
+                    'elongCut' => ellipticity_cut}
+                
+          begin
+            # If an output file is specified, retrieve the fixed FITS and save it locally.
+            retrieval_url = @driver.fixUrl(params.to_soap_map)['FixUrlResult']
+            (output_file != nil)? (return VORuby::Utilities::save_to(output_file, URI.parse(retrieval_url).read)): (return retrieval_url)
+          rescue SOAP::FaultError => sfe
+            raise WCSFixerSoapException, sfe
+          end
+        end
+    
+        # Corrects a FITS image with WCS information.
+        def fix(fitsfile, output_file, calibration_db="SDSSDR3", approx_img_offset=5.0, num_objects=50, ellipticity_cut=1.2)
+          params = {'fitsfile' => File.read(fitsfile),
+                    'db' => calibration_db,
+                    'offset' => approx_img_offset,
+                    'numObjects' => num_objects,
+                    'elongCut' => ellipticity_cut}
+                
+          begin
+              corrected_fits = @driver.fix(params.to_soap_map)['FixWithoutWcsResult']
+              return VORuby::Utilities::save_to(output_file, corrected_fits)
+          rescue SOAP::FaultError => sfe
+              raise WCSFixerSoapException, sfe
+          end
+        end
+    
+        # Corrects a FITS image URL without WCS information.
+        # If output_file is specified, the corrected FITS images is retrieved and stored locally,
+        # otherwise its URI is returned.
+        def fixWithoutWcsUrl(url, output_file,
+          ra_center, dec_center, pixel_scale,
+          calibration_db="SDSSDR3", approx_img_offset=5.0, num_objects=50, ellipticity_cut=1.2)
+          params = {'url' => url,
+                    'db' => calibration_db,
+                    'offset' => approx_img_offset,
+                    'numObjects' => num_objects,
+                    'elongCut' => ellipticity_cut,
+                    'raCenter' => ra_center,
+                    'decCenter' => dec_center,
+                    'pixelScale' => pixel_scale}
+                
+          begin
+              # If an output file is specified, retrieve the fixed FITS and save it locally.
+              retrieval_url = @driver.fixWithoutWcsUrl(params.to_soap_map)['FixUrlResult']
+              (output_file != nil)? (return VORuby::Utilities::save_to(output_file, URI.parse(retrieval_url).read)): (return retrieval_url)
+          rescue SOAP::FaultError => sfe
+              raise WCSFixerSoapException, sfe
+          end
+        end
+    
+        # Corrects a FITS image with WCS information.
+        def fixWithoutWcs(fitsfile, output_file,
+          ra_center, dec_center, pixel_scale,
+          calibration_db="SDSSDR3", approx_img_offset=5.0, num_objects=50, ellipticity_cut=1.2)
+          params = {'fitsfile' => File.read(fitsfile),
+                    'db' => calibration_db,
+                    'offset' => approx_img_offset,
+                    'numObjects' => num_objects,
+                    'elongCut' => ellipticity_cut,
+                    'raCenter' => ra_center,
+                    'decCenter' => dec_center,
+                    'pixelScale' => pixel_scale}
+                
+          begin
+            corrected_fits = @driver.fixWithoutWcs(params.to_soap_map)['FixWithoutWcsResult']
+            return VORuby::Utilities::save_to(output_file, corrected_fits)
+          rescue SOAP::FaultError => sfe
+            raise WCSFixerSoapException, sfe
+          end
+        end
+      end
+  
+    end
+  end
+end

data/lib/voruby/services/gestalt/wesix.rb

@@ -0,0 +1,155 @@
+require 'voruby/services/loader'
+
+module VORuby
+  module Services
+    module Gestalt
+  
+      class WesixException < RuntimeError; end
+      class NoVotableException < WesixException
+        def initialize
+          super('VOTABLE missing from SOAP response. ' +
+                'Often this is caused by an overly large catalog. ' +
+                'Try increasing your detection threshold.')
+        end
+      end
+  
+      class Wesix
+        attr_reader :factory, :driver,
+          :allowed_in_params, :allowed_out_params, :in_params, :out_params
+    
+        def initialize(driver, bootstrap=true, debug=false)
+          @driver = driver
+          @driver.wiredump_dev = $stderr if debug
+      
+          @in_params = {}
+          @out_params = {}
+      
+          define_accessors()
+          bootstrap_params() if bootstrap
+        end
+    
+        def self.from_wsdl(wsdl="http://nvogre.phyast.pitt.edu:8080/axis/services/WesixTest?wsdl", bootstrap=true, debug=false)
+          return Wesix.new(SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver, bootstrap, debug)
+        end
+    
+        def define_accessors
+          @allowed_in_params = []
+          @allowed_out_params = []
+      
+          @driver.proxy.literal_mapping_registry.definedtypes.each do |el|
+            case el.name.name
+            when 'SexParams'
+              el.each_element do |ctype|
+                @allowed_in_params.push(ctype.name.name)
+                meta_def(ctype.name.name.downcase){get_in_param(ctype.name.name)}
+                meta_def(ctype.name.name.downcase + '='){|value| set_in_param(ctype.name.name, value)}
+              end
+            when 'SexOutputParams'
+              el.each_element do |ctype|
+                @allowed_out_params.push(ctype.name.name)
+                meta_def(ctype.name.name.downcase){get_out_param(ctype.name.name)}
+                meta_def(ctype.name.name.downcase + '='){|value| set_out_param(ctype.name.name, value)}
+              end
+            end
+          end
+        end
+    
+        def bootstrap_params
+          bootstrap_in_params
+          bootstrap_out_params
+        end
+    
+        def reset_params
+          reset_in_params
+          reset_out_params
+        end
+    
+        def bootstrap_in_params
+          in_params = @driver.getSexParams()[0]
+          @allowed_in_params.each do |param_name|
+              @in_params[param_name] = in_params[param_name]
+          end
+        end
+    
+        def reset_in_params
+          @in_params = {}
+        end
+    
+        def bootstrap_out_params
+          out_params = @driver.getSexOutputParams()[0]
+          @allowed_out_params.each do |param_name|
+              @out_params[param_name] = out_params[param_name]
+          end
+        end
+    
+        def reset_out_params
+          @out_params = {}
+        end
+    
+        def set_in_param(name, value)
+          if @allowed_in_params.include?(name)
+            @in_params[name] = value
+          else
+            raise "Input parameter #{name} is not recognized"
+          end
+        end
+    
+        def get_in_param(name)
+          @in_params[name]
+        end
+    
+        def set_out_param(name, value)
+          if @allowed_out_params.include?(name)
+            @out_params[name] = value
+          else
+            raise "Output parameter #{name} is not recognized"
+          end
+        end
+    
+        def get_out_param(name)
+          @out_params[name]
+        end
+    
+        def _file_as_string(file)
+          bytes = nil
+          File.open(file){ |file_obj|
+            bytes = file_obj.readlines.join()
+          }
+      
+          return bytes
+        end
+    
+        def wsextractor3VO(file, flag=0)
+          response = @driver.wsextractor3VO(_file_as_string(file), @in_params.to_soap_map, @out_params.to_soap_map, flag)
+          return VOTable::VOTable.from_soap_obj(response[0].vOTABLE) if response[0].respond_to?(:vOTABLE)
+      
+          raise NoVotableException
+        end
+    
+        def wsextractor3VOXmatch(file, flag=0)
+          response = @driver.wsextractor3VOXmatch(_file_as_string(file), @in_params.to_soap_map, @out_params.to_soap_map, flag)
+          return VOTable::VOTable.from_soap_obj(response[0].vOTABLE) if response[0].respond_to?(:vOTABLE)
+      
+          raise NoVotableException
+        end
+    
+        def wsextractorURL3VO(file, flag=0)
+          response = @driver.wsextractorURL3VO(file, @in_params.to_soap_map, @out_params.to_soap_map, flag)
+          return VOTables::VOTable::VOTable.from_soap_obj(response[0].vOTABLE) if response[0].respond_to?(:vOTABLE)
+     
+          raise NoVotableException
+        end
+    
+        def wsextractorURL3VOXmatch(file, flag=0)
+          response = @driver.wsextractorURL3VOXmatch(file, @in_params.to_soap_map, @out_params.to_soap_map, flag)
+          return VOTable::VOTable.from_soap_obj(response[0].vOTABLE) if response[0].respond_to?(:vOTABLE)
+      
+          raise NoVotableException
+        end
+    
+        private :define_accessors, :bootstrap_in_params, :bootstrap_out_params, :bootstrap_params, :_file_as_string
+      end
+  
+    end
+  end
+end

data/lib/voruby/services/loader.rb

@@ -0,0 +1,7 @@
+require 'open-uri'
+require 'soap/wsdlDriver'
+require 'rexml/document'
+
+require 'voruby/loader'
+require 'voruby/services/ext'
+require 'voruby/votables/votable'

data/lib/voruby/services/registry/registry.rb

@@ -0,0 +1,53 @@
+require 'tmpdir'
+
+require 'voruby/services/loader'
+require 'voruby/resources/stsci'
+
+module VORuby
+  module Services
+    module Registry
+      
+      class STScI
+        attr_reader :factory, :driver
+        
+        def initialize(driver, debug=false)
+          @driver = driver
+          @driver.wiredump_dev = $stderr if debug
+          
+          # This is basically a big hack.  We are going to ignore everything soap4r
+          # does for us in terms of interpreting the result of a query.  Instead
+          # we'll dump the raw SOAP to file and parse it on our own.  This is obviously
+          # not optimal, but works for now.
+          @driver.wiredump_file_base = Dir::tmpdir() + '/stsci_registry'
+        end
+        
+        def self.from_wsdl(wsdl="http://nvo.stsci.edu/VORegistry/registry.asmx?WSDL", debug=false)
+          return STScI.new(SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver, debug)
+        end
+        
+        def queryVOResource(predicate)
+          params = {'predicate' => predicate}
+          
+          request_file = @driver.wiredump_file_base() + '_queryVOResource_request.xml'
+          response_file = @driver.wiredump_file_base() + '_queryVOResource_response.xml'
+          
+          # Query the registry
+          @driver.queryVOResource(params.to_soap_map)
+          
+          # Parse the returned SOAP envelope and extract the query result
+          soap_envelope = REXML::Document.new File.new(response_file)
+          response = REXML::XPath.first(soap_envelope.root, '//QueryVOResourceResult')
+          
+          # Convert the result into our own domain objects
+          resources = VORuby::Resources::STScI::ArrayOfResource.load_from_xml(VORuby::Resources::STScI::clean(response))
+          
+          # Clean up the wiredump files.
+          File.unlink(request_file, response_file)
+          
+          return resources
+        end
+      end
+      
+    end
+  end
+end

data/lib/voruby/services/resolver/resolver.rb

@@ -0,0 +1,35 @@
+require 'voruby/services/loader'
+
+require 'voruby/sesame/sesame_v1_0'
+
+include VORuby::Sesame::V1_0
+
+module VORuby
+  module Services
+    module Resolver
+      
+      class Sesame
+        attr_reader :factor, :driver
+        
+        def initialize(driver, debug=false)
+          @driver = driver
+          @driver.wiredump_dev = $stderr if debug
+        end
+        
+        def self.from_wsdl(wsdl='http://vizier.cfa.harvard.edu:8080/axis/services/Sesame?wsdl', debug=false)
+          return Sesame.new(SOAP::WSDLDriverFactory.new(wsdl).create_rpc_driver, debug)
+        end
+        
+        def query(object_name)
+          VORuby::Sesame::V1_0::Sesame.load_from_xml(REXML::Document.new(@driver.sesameXML(object_name)).root)
+        end
+        
+        def query_position(object_name)
+          query = query(object_name)
+          Equatorial::RADecPosition.new(query.resolvers[0].jradeg, query.resolvers[0].jdedeg)
+        end
+      end
+      
+    end
+  end
+end

data/lib/voruby/sesame/loader.rb

@@ -0,0 +1,6 @@
+require 'rubygems'
+require 'xml/mapping'
+
+require 'voruby/loader'
+
+require 'voruby/resources/nodes'

data/lib/voruby/sesame/sesame_v1_0.rb

@@ -0,0 +1,64 @@
+require 'voruby/sesame/loader'
+
+require 'voruby/spacetime/spacetime'
+
+include VORuby::CoordinateSystems
+
+module VORuby
+  module Sesame
+    module V1_0
+      
+      # Forward declarations
+      class Sesame; end
+      class Target; end
+      class SimpleString; end
+      class Resolver; end
+      
+      # Sesame is the root element.
+      class Sesame
+        include XML::Mapping
+        
+        array_node :info, 'INFO', :class => SimpleString, :optional => true, :default_value => []
+        array_node :errors, 'ERROR', :class => SimpleString, :optional => true, :default_value => []
+        array_node :resolvers, 'Resolver', :class => Resolver, :optional => false
+        
+        object_node :target, 'target', :class => Target, :optional => false
+      end
+      
+      class Target
+        include XML::Mapping
+        
+        text_node :value, '', :optional => false
+        text_node :option, '@option', :optional => false
+      end
+      
+      class SimpleString
+        include XML::Mapping
+        
+        text_node :value, '', :optional => false
+      end
+      
+      class Resolver
+        include XML::Mapping
+        
+        array_node :info, 'INFO', :class => SimpleString, :optional => true, :default_value => []
+        array_node :errors, 'ERROR', :class => SimpleString, :optional => true, :default_value => []
+        array_node :aliases, 'alias', :class => SimpleString, :optional => true, :default_value => []
+        
+        text_node :otype, 'otype', :optional => true
+        text_node :jpos, 'jpos', :optional => true
+        text_node :ref_pos, 'refPos', :optional => true
+        text_node :oname, 'oname', :optional => true
+        text_node :name, '@name', :optional => false
+        text_node :code, '@code', :optional => true
+        
+        numeric_node :jradeg, 'jradeg', :optional => true
+        numeric_node :jdedeg, 'jdedeg', :optional => true
+        numeric_node :err_ra_mas, 'errRAmas', :optional => true
+        numeric_node :err_de_mas, 'errDEmas', :optional => true
+        numeric_node :nrefs, 'nrefs', :optional => true
+      end
+      
+    end
+  end
+end

data/lib/voruby/simple/loader.rb

@@ -0,0 +1,6 @@
+require 'net/http'
+require 'tempfile'
+
+require 'voruby/loader'
+require 'voruby/simple/parameters'
+require 'voruby/votables/tree'