Merge potlatch_010 branch to head.
[rails.git] / app / controllers / amf_controller.rb
1 # AMF Controller is a semi-standalone API for Flash clients, particularly Potlatch.
2 # All interaction between Potlatch (as a .SWF application) and the 
3 # OSM database takes place using this controller. Messages are 
4 # encoded in the Actionscript Message Format (AMF).
5 #
6 # See Also Potlatch::Potlatch and Potlatch::AMF
7 #
8 # Public domain.
9 # editions Systeme D / Richard Fairhurst 2004-2008
10 #
11 # All in/out parameters are floats unless explicitly stated.
12
13 # to trap errors (getway_old,putway,putpoi,deleteway only):
14 #   return(-1,"message")                <-- just puts up a dialogue
15 #   return(-2,"message")                <-- also asks the user to e-mail me
16 # to log:
17 #   RAILS_DEFAULT_LOGGER.error("Args: #{args[0]}, #{args[1]}, #{args[2]}, #{args[3]}")
18 class AmfController < ApplicationController
19   require 'stringio'
20
21   include Potlatch
22
23   session :off
24   before_filter :check_write_availability
25
26   # Main AMF handler. Tha talk method takes in AMF, figures out what to do and dispatched to the appropriate private method
27   def talk
28     req=StringIO.new(request.raw_post+0.chr)    # Get POST data as request
29     # (cf http://www.ruby-forum.com/topic/122163)
30     req.read(2)                                                                 # Skip version indicator and client ID
31     results={}                                                                  # Results of each body
32     renumberednodes={}                                                  # Shared across repeated putways
33     renumberedways={}                                                   # Shared across repeated putways
34
35     # -------------
36     # Parse request
37
38     headers=AMF.getint(req)                                     # Read number of headers
39
40     headers.times do                                # Read each header
41       name=AMF.getstring(req)                           #  |
42       req.getc                                  #  | skip boolean
43       value=AMF.getvalue(req)                           #  |
44       header["name"]=value                              #  |
45     end
46
47     bodies=AMF.getint(req)                                      # Read number of bodies
48     bodies.times do                                     # Read each body
49       message=AMF.getstring(req)                        #  | get message name
50       index=AMF.getstring(req)                          #  | get index in response sequence
51       bytes=AMF.getlong(req)                            #  | get total size in bytes
52       args=AMF.getvalue(req)                            #  | get response (probably an array)
53
54       case message
55       when 'getpresets';                results[index]=AMF.putdata(index,getpresets)
56       when 'whichways';                 results[index]=AMF.putdata(index,whichways(args))
57       when 'whichways_deleted'; results[index]=AMF.putdata(index,whichways_deleted(args))
58       when 'getway';                    results[index]=AMF.putdata(index,getway(args))
59       when 'getrelation';               results[index]=AMF.putdata(index,getrelation(args))
60       when 'getway_old';                results[index]=AMF.putdata(index,getway_old(args))
61       when 'getway_history';    results[index]=AMF.putdata(index,getway_history(args))
62       when 'putway';                    r=putway(args,renumberednodes)
63                                                                 renumberednodes=r[3]
64                                                                 if r[1] != r[2]
65                                                                         renumberedways[r[1]] = r[2]
66                                                                 end
67                                                                 results[index]=AMF.putdata(index,r)
68       when 'putrelation';               results[index]=AMF.putdata(index,putrelation(args, renumberednodes, renumberedways))
69       when 'deleteway';                 results[index]=AMF.putdata(index,deleteway(args))
70       when 'putpoi';                    results[index]=AMF.putdata(index,putpoi(args))
71       when 'getpoi';                    results[index]=AMF.putdata(index,getpoi(args))
72       end
73     end
74
75     # ------------------
76     # Write out response
77
78     RAILS_DEFAULT_LOGGER.info("  Response: start")
79     a,b=results.length.divmod(256)
80     render :content_type => "application/x-amf", :text => proc { |response, output| 
81       output.write 0.chr+0.chr+0.chr+0.chr+a.chr+b.chr
82       results.each do |k,v|
83         output.write(v)
84       end
85     }
86     RAILS_DEFAULT_LOGGER.info("  Response: end")
87   end
88
89   private
90
91   # Return presets (default tags and crap) to potlatch.
92   # Uses POTLATCH_PRESETS global, set up in OSM::Potlatch
93   def getpresets #:doc:
94     return POTLATCH_PRESETS
95   end
96
97   # ----- whichways
98   # Find all the way ids and nodes (including tags and projected lat/lng) which aren't part of those ways in an are
99   # 
100   # The argument is an array containing the following, in order:
101   # 0. minimum longitude
102   # 1. minimum latitude
103   # 2. maximum longitude
104   # 3. maximum latitude
105   # 4. baselong, 5. basey, 6. masterscale as above
106   def whichways(args) #:doc:
107     xmin = args[0].to_f-0.01
108     ymin = args[1].to_f-0.01
109     xmax = args[2].to_f+0.01
110     ymax = args[3].to_f+0.01
111     baselong    = args[4]
112     basey       = args[5]
113     masterscale = args[6]
114
115   def whichways(xmin, ymin, xmax, ymax) #:doc:
116         xmin -= 0.01; ymin -= 0.01
117         xmax += 0.01; ymax += 0.01
118
119         if POTLATCH_USE_SQL then
120           way_ids = sql_find_way_ids_in_area(xmin, ymin, xmax, ymax)
121           points = sql_find_pois_in_area(xmin, ymin, xmax, ymax)
122           relation_ids = sql_find_relations_in_area_and_ways(xmin, ymin, xmax, ymax, way_ids)
123         else
124           # find the way ids in an area
125           nodes_in_area = Node.find_by_area(ymin, xmin, ymax, xmax, :conditions => "current_nodes.visible = 1", :include => :ways)
126           way_ids = nodes_in_area.collect { |node| node.way_ids }.flatten.uniq
127
128     # find the node ids in an area that aren't part of ways
129     nodes_not_used_in_area = nodes_in_area.select { |node| node.ways.empty? }
130     points = nodes_not_used_in_area.collect { |n| [n.id, n.lon_potlatch(baselong,masterscale), n.lat_potlatch(basey,masterscale), n.tags_as_hash] }
131
132           # find the relations used by those nodes and ways
133           relations = Relation.find_for_nodes(nodes_in_area.collect { |n| n.id }, :conditions => "visible = 1") +
134                   Relation.find_for_ways(way_ids, :conditions => "visible = 1")
135           relation_ids = relations.collect { |relation| relation.id }.uniq
136         end
137
138         [way_ids, points, relation_ids]
139   end
140
141   # ----- whichways_deleted
142   #               return array of deleted ways in current bounding box
143   #               in:   as whichways
144   #               does: finds all deleted ways with a deleted node in bounding box
145   #               out:  [0] array of way ids
146   def whichways_deleted(args) #:doc:
147     xmin = args[0].to_f-0.01
148     ymin = args[1].to_f-0.01
149     xmax = args[2].to_f+0.01
150     ymax = args[3].to_f+0.01
151     baselong    = args[4]
152     basey       = args[5]
153     masterscale = args[6]
154
155   def whichways_deleted(xmin, ymin, xmax, ymax) #:doc:
156         xmin -= 0.01; ymin -= 0.01
157         xmax += 0.01; ymax += 0.01
158
159         nodes_in_area = Node.find_by_area(ymin, xmin, ymax, xmax, :conditions => "current_nodes.visible = 0 AND current_ways.visible = 0", :include => :ways_via_history)
160         way_ids = nodes_in_area.collect { |node| node.ways_via_history_ids }.flatten.uniq
161
162         [way_ids]
163   end
164
165   # ----- getway
166   # Get a way with all of it's nodes and tags
167   # The input is an array with the following components, in order:
168   # 0. wayid - the ID of the way to get
169   # 1. baselong - origin of SWF map (longitude)
170   # 2. basey - origin of SWF map (latitude)
171   # 3. masterscale - SWF map scale
172   #
173   # The output is an array which contains all the nodes (with projected 
174   # latitude and longitude) and tags for a way (and all the nodes tags). 
175   # It also has the way's unprojected (WGS84) bbox.
176   #
177   # FIXME: The server really shouldn't be figuring out a ways bounding box and doing projection for potlatch
178   # FIXME: the argument splitting should be done in the 'talk' method, not here
179   def getway(args) #:doc:
180     wayid,baselong,basey,masterscale = args
181     wayid = wayid.to_i
182
183   def getway(wayid) #:doc:
184         if POTLATCH_USE_SQL then
185           points = sql_get_nodes_in_way(wayid)
186           tags = sql_get_tags_in_way(wayid)
187         else
188           # Ideally we would do ":include => :nodes" here but if we do that
189           # then rails only seems to return the first copy of a node when a
190           # way includes a node more than once
191           way = Way.find(wayid)
192           points = way.nodes.collect do |node|
193                 [node.lon, node.lat, node.id, nil, node.tags_as_hash]
194           end
195           tags = way.tags
196         end
197
198         [wayid, points, tags]
199   end
200
201   # ----- getway_old
202   #               returns old version of way
203   #               in:   [0] way id,
204   #                             [1] way version to get (or -1 for "last deleted version")
205   #                             [2] baselong, [3] basey, [4] masterscale
206   #               does: gets old version of way and all constituent nodes
207   #                             for undelete, always uses the most recent version of each node
208   #                               (even if it's moved)
209   #                             for revert, uses the historic version of each node, but if that node is
210   #                               still visible and has been changed since, generates a new node id
211   #               out:  [0] 0 (code for success), [1] SWF object name,
212   #                             [2] array of points (as getway _except_ [3] is node.visible?, 0 or 1),
213   #                             [4] xmin, [5] xmax, [6] ymin, [7] ymax (unprojected bbox),
214   #                             [8] way version
215   def getway_old(args) #:doc:
216     RAILS_DEFAULT_LOGGER.info("  Message: getway_old (server is #{SERVER_URL})")
217     #   if SERVER_URL=="www.openstreetmap.org" then return -1,"Revert is not currently enabled on the OpenStreetMap server." end
218
219   def getway_old(id, version) #:doc:
220         if version < 0
221           old_way = OldWay.find(:first, :conditions => ['visible = 1 AND id = ?', id], :order => 'version DESC')
222           points = old_way.get_nodes_undelete
223         else
224           old_way = OldWay.find(:first, :conditions => ['id = ? AND version = ?', id, version])
225           points = old_way.get_nodes_revert
226         end
227
228         old_way.tags['history'] = "Retrieved from v#{old_way.version}"
229
230         [0, id, points, old_way.tags, old_way.version]
231   end
232
233   def getway_history(wayid) #:doc:
234         history = Way.find(wayid).old_ways.collect do |old_way|
235           user = old_way.user.data_public? ? old_way.user.display_name : 'anonymous'
236           [old_way.version, old_way.timestamp.strftime("%d %b %Y, %H:%M"), old_way.visible ? 1 : 0, user]
237         end
238
239         [history]
240   end
241
242   # Get a relation with all tags and members.
243   # Returns:
244   # 0. relation id,
245   # 1. hash of tags,
246   # 2. list of members.
247   
248   def getrelation(relid) #:doc:
249         rel = Relation.find(relid)
250
251         [relid, rel.tags, rel.members]
252   end
253
254   # ----- getrelation
255   #               save relation to the database
256   #               in:   [0] user token (string),
257   #                             [1] original relation id (may be negative),
258   #                             [2] hash of tags, [3] list of members,
259   #                             [4] visible
260   #               out:  [0] 0 (success), [1] original relation id (unchanged),
261   #                             [2] new relation id
262   def putrelation(args, renumberednodes, renumberedways) #:doc:
263     usertoken,relid,tags,members,visible=args
264     uid=getuserid(usertoken)
265     if !uid then return -1,"You are not logged in, so the point could not be saved." end
266
267   def putrelation(renumberednodes, renumberedways, usertoken, relid, tags, members, visible) #:doc:
268         uid = getuserid(usertoken)
269         if !uid then return -1,"You are not logged in, so the relation could not be saved." end
270
271         relid = relid.to_i
272         visible = visible.to_i
273
274         # create a new relation, or find the existing one
275     if relid <= 0
276       rel = Relation.new
277     else
278       rel = Relation.find(relid)
279     end
280
281     # check the members are all positive, and correctly type
282     typedmembers = []
283     members.each do |m|
284       mid = m[1].to_i
285       if mid < 0
286         mid = renumberednodes[mid] if m[0] == 'node'
287         mid = renumberedways[mid] if m[0] == 'way'
288         if mid < 0
289           return -2, "Negative ID unresolved"
290         end
291       end
292       typedmembers << [m[0], mid, m[2]]
293     end
294
295         # assign new contents
296         rel.members = typedmembers
297         rel.tags = tags
298         rel.visible = visible
299         rel.user_id = uid
300
301     # check it then save it
302     # BUG: the following is commented out because it always fails on my
303     #  install. I think it's a Rails bug.
304
305     #if !rel.preconditions_ok?
306     #  return -2, "Relation preconditions failed"
307     #else
308       rel.save_with_history!
309     #end
310
311         [0, relid, rel.id]
312   end
313
314   # ----- putway
315   #               saves a way to the database
316   #               in:   [0] user token (string),
317   #                             [1] original way id (may be negative), 
318   #                             [2] array of points (as getway/getway_old),
319   #                             [3] hash of way tags,
320   #                             [4] original way version (0 if not a reverted/undeleted way),
321   #                             [5] baselong, [6] basey, [7] masterscale
322   #               does: saves way to the database
323   #                             all constituent nodes are created/updated as necessary
324   #                             (or deleted if they were in the old version and are otherwise unused)
325   #               out:  [0] 0 (code for success), [1] original way id (unchanged),
326   #                             [2] new way id, [3] hash of renumbered nodes (old id=>new id),
327   #                             [4] xmin, [5] xmax, [6] ymin, [7] ymax (unprojected bbox)
328   def putway(args,renumberednodes) #:doc:
329     RAILS_DEFAULT_LOGGER.info("  putway started")
330     usertoken,originalway,points,attributes,oldversion,baselong,basey,masterscale=args
331     uid=getuserid(usertoken)
332     if !uid then return -1,"You are not logged in, so the way could not be saved." end
333
334   def putway(renumberednodes, usertoken, originalway, points, attributes) #:doc:
335
336         # -- Initialise and carry out checks
337         
338         uid = getuserid(usertoken)
339         if !uid then return -1,"You are not logged in, so the way could not be saved." end
340
341         originalway = originalway.to_i
342
343         points.each do |a|
344           if a[2] == 0 or a[2].nil? then return -2,"Server error - node with id 0 found in way #{originalway}." end
345           if a[1] == 90 then return -2,"Server error - node with lat -90 found in way #{originalway}." end
346         end
347
348         if points.length < 2 then return -2,"Server error - way is only #{points.length} points long." end
349
350     # -- 3.     read original way into memory
351
352         if originalway < 0
353           way = Way.new
354           uniques = []
355         else
356           way = Way.find(originalway)
357           uniques = way.unshared_node_ids
358         end
359
360     # -- 4.     get version by inserting new row into ways
361
362         nodes = []
363
364         points.each do |n|
365           lon = n[0].to_f
366           lat = n[1].to_f
367           id = n[2].to_i
368           savenode = false
369
370           if renumberednodes[id]
371             id = renumberednodes[id]
372           elsif id < 0
373                 # Create new node
374                 node = Node.new
375                 savenode = true
376           else
377                 node = Node.find(id)
378                 if !fpcomp(lat, node.lat) or !fpcomp(lon, node.lon) or
379                    Tags.join(n[4]) != node.tags or !node.visible?
380                   savenode = true
381                 end
382           end
383
384           if savenode
385                 node.user_id = uid
386             node.lat = lat
387         node.lon = lon
388             node.tags = Tags.join(n[4])
389             node.visible = true
390             node.save_with_history!
391
392                 if id != node.id
393                   renumberednodes[id] = node.id
394                   id = node.id
395             end
396           end
397
398           uniques = uniques - [id]
399           nodes.push(id)
400         end
401
402         # -- Delete any unique nodes
403         
404         uniques.each do |n|
405           deleteitemrelations(n, 'node')
406
407           node = Node.find(n)
408           node.user_id = uid
409           node.visible = false
410           node.save_with_history!
411         end
412
413     points.each_index do |i|
414       xs=coord2long(points[i][0],masterscale,baselong)
415       ys=coord2lat(points[i][1],masterscale,basey)
416       xmin=[xs,xmin].min; xmax=[xs,xmax].max
417       ymin=[ys,ymin].min; ymax=[ys,ymax].max
418       node=points[i][2].to_i
419       tagstr=array2tag(points[i][4])
420       tagsql="'"+sqlescape(tagstr)+"'"
421       lat=(ys * 10000000).round
422       long=(xs * 10000000).round
423       tile=QuadTile.tile_for_point(ys, xs)
424
425         way.tags = attributes
426         way.nds = nodes
427         way.user_id = uid
428         way.visible = true
429         way.save_with_history!
430
431         [0, originalway, way.id, renumberednodes]
432   end
433
434   # ----- putpoi
435   #               save POI to the database
436   #               in:   [0] user token (string),
437   #                             [1] original node id (may be negative),
438   #                             [2] projected longitude, [3] projected latitude,
439   #                             [4] hash of tags, [5] visible (0 to delete, 1 otherwise), 
440   #                             [6] baselong, [7] basey, [8] masterscale
441   #               does: saves POI node to the database
442   #                             refuses save if the node has since become part of a way
443   #               out:  [0] 0 (success), [1] original node id (unchanged),
444   #                             [2] new node id
445   def putpoi(args) #:doc:
446     usertoken,id,x,y,tags,visible,baselong,basey,masterscale=args
447     uid=getuserid(usertoken)
448     if !uid then return -1,"You are not logged in, so the point could not be saved." end
449
450   def putpoi(usertoken, id, lon, lat, tags, visible) #:doc:
451         uid = getuserid(usertoken)
452         if !uid then return -1,"You are not logged in, so the point could not be saved." end
453
454         id = id.to_i
455         visible = (visible.to_i == 1)
456
457         if id > 0 then
458           node = Node.find(id)
459
460           if !visible then
461             unless node.ways.empty? then return -1,"The point has since become part of a way, so you cannot save it as a POI." end
462             deleteitemrelations(id, 'node')
463           end
464         else
465           node = Node.new
466         end
467
468         node.user_id = uid
469         node.lat = lat
470         node.lon = lon
471         node.tags = Tags.join(tags)
472         node.visible = visible
473         node.save_with_history!
474
475         [0, id, node.id]
476   end
477
478   # ----- getpoi
479   # read POI from database
480   #               (only called on revert: POIs are usually read by whichways)
481   #               in:   [0] node id, [1] baselong, [2] basey, [3] masterscale
482   #               does: reads POI
483   #               out:  [0] id (unchanged), [1] projected long, [2] projected lat,
484   #                             [3] hash of tags
485   def getpoi(args) #:doc:
486     id,baselong,basey,masterscale = args
487     
488     n = Node.find(id.to_i)
489     if n
490       return [n.id, n.lon_potlatch(baselong,masterscale), n.lat_potlatch(basey,masterscale), n.tags_as_hash]
491     else
492       return [nil,nil,nil,'']
493     end
494   end
495
496   def getpoi(id) #:doc:
497         n = Node.find(id)
498
499         if n
500           return [n.id, n.lon, n.lat, n.tags_as_hash]
501         else
502           return [nil, nil, nil, '']
503         end
504   end
505
506
507   def deleteway(usertoken, way_id) #:doc:
508         uid = getuserid(usertoken)
509         if !uid then return -1,"You are not logged in, so the way could not be deleted." end
510
511         # FIXME: would be good not to make two history entries when removing
512         #                two nodes from the same relation
513         user = User.find(uid)
514         way = Way.find(way_id)
515         way.unshared_node_ids.each do |n|
516           deleteitemrelations(n, 'node')
517         end
518
519         way.delete_with_relations_and_nodes_and_history(user)  
520
521         [0, way_id]
522   end
523
524   def createuniquenodes(way,uqn_name,nodelist) #:doc:
525     # Find nodes which appear in this way but no others
526     sql=<<-EOF
527   CREATE TEMPORARY TABLE #{uqn_name}
528           SELECT a.node_id
529             FROM (SELECT DISTINCT node_id FROM current_way_nodes
530               WHERE id=#{way}) a
531          LEFT JOIN current_way_nodes b
532             ON b.node_id=a.node_id
533              AND b.id!=#{way}
534            WHERE b.node_id IS NULL
535   EOF
536     unless nodelist.empty? then
537       sql+="AND a.node_id NOT IN ("+nodelist.join(',')+")"
538     end
539     ActiveRecord::Base.connection.execute(sql)
540   end
541
542
543
544   # ====================================================================
545   # Relations handling
546   # deleteuniquenoderelations(uqn_name,uid,db_now)
547   # deleteitemrelations(way|node,'way'|'node',uid,db_now)
548
549   def deleteuniquenoderelations(uqn_name,uid,db_now) #:doc:
550     sql=<<-EOF
551   SELECT node_id,cr.id FROM #{uqn_name},current_relation_members crm,current_relations cr 
552    WHERE crm.member_id=node_id 
553      AND crm.member_type='node' 
554      AND crm.id=cr.id 
555      AND cr.visible=1
556   EOF
557
558   def deleteitemrelations(objid, type) #:doc:
559         relations = RelationMember.find(:all, 
560                                                                         :conditions => ['member_type = ? and member_id = ?', type, objid], 
561                                                                         :include => :relation).collect { |rm| rm.relation }.uniq
562
563         relations.each do |rel|
564           rel.members.delete_if { |x| x[0] == type and x[1] == objid }
565           rel.save_with_history!
566         end
567   end
568
569   def deleteitemrelations(objid,type,uid,db_now) #:doc:
570     sql=<<-EOF
571   SELECT cr.id FROM current_relation_members crm,current_relations cr 
572    WHERE crm.member_id=#{objid} 
573      AND crm.member_type='#{type}' 
574      AND crm.id=cr.id 
575      AND cr.visible=1
576   EOF
577
578     relways=ActiveRecord::Base.connection.select_all(sql)
579     relways.each do |a|
580       removefromrelation(objid,type,a['id'],uid,db_now)
581     end
582   end
583
584   def removefromrelation(objid,type,relation,uid,db_now) #:doc:
585     rver=ActiveRecord::Base.connection.insert("INSERT INTO relations (id,user_id,timestamp,visible) VALUES (#{relation},#{uid},#{db_now},1)")
586
587     tagsql=<<-EOF
588   INSERT INTO relation_tags (id,k,v,version) 
589   SELECT id,k,v,#{rver} FROM current_relation_tags 
590    WHERE id=#{relation} 
591   EOF
592     ActiveRecord::Base.connection.insert(tagsql)
593
594     membersql=<<-EOF
595   INSERT INTO relation_members (id,member_type,member_id,member_role,version) 
596   SELECT id,member_type,member_id,member_role,#{rver} FROM current_relation_members 
597    WHERE id=#{relation} 
598      AND (member_id!=#{objid} OR member_type!='#{type}')
599   EOF
600     ActiveRecord::Base.connection.insert(membersql)
601
602     ActiveRecord::Base.connection.update("UPDATE current_relations SET user_id=#{uid},timestamp=#{db_now} WHERE id=#{relation}")
603     ActiveRecord::Base.connection.execute("DELETE FROM current_relation_members WHERE id=#{relation} AND member_type='#{type}' AND member_id=#{objid}")
604   end
605
606   def sqlescape(a) #:doc:
607     a.gsub(/[\000-\037]/,"").gsub("'","''").gsub(92.chr) {92.chr+92.chr}
608   end
609
610   def tag2array(a) #:doc:
611     tags={}
612     Tags.split(a) do |k, v|
613       tags[k.gsub(':','|')]=v
614     end
615     tags
616   end
617
618   def array2tag(a) #:doc:
619     tags = []
620     a.each do |k,v|
621       if v=='' then next end
622       if v[0,6]=='(type ' then next end
623       tags << [k.gsub('|',':'), v]
624     end
625     return Tags.join(tags)
626   end
627
628   def getuserid(token) #:doc:
629     if (token =~ /^(.+)\+(.+)$/) then
630       user = User.authenticate(:username => $1, :password => $2)
631     else
632       user = User.authenticate(:token => token)
633     end
634
635     return user ? user.id : nil;
636   end
637
638   # ====================================================================
639   # Co-ordinate conversion
640
641   def lat2coord(a,basey,masterscale) #:doc:
642     -(lat2y(a)-basey)*masterscale
643   end
644
645   def long2coord(a,baselong,masterscale) #:doc:
646     (a-baselong)*masterscale
647   end
648
649   def lat2y(a) #:doc:
650     180/Math::PI * Math.log(Math.tan(Math::PI/4+a*(Math::PI/180)/2))
651   end
652
653   def coord2lat(a,masterscale,basey) #:doc:
654     y2lat(a/-masterscale+basey)
655   end
656
657   def coord2long(a,masterscale,baselong) #:doc:
658     a/masterscale+baselong
659   end
660
661   def y2lat(a)
662     180/Math::PI * (2*Math.atan(Math.exp(a*Math::PI/180))-Math::PI/2)
663   end
664
665 end
666
667 # Local Variables:
668 # indent-tabs-mode: t
669 # tab-width: 4
670 # End: