telescope-term 0.3 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 787c1ac3f1065fa3ba4b3b6622cfe545a5701a8630ed9541cddd86b90fe3a609
-  data.tar.gz: cee7a96f1efd1b494b78524ed788826f83f743362702da4fc87963077eee44d3
+  metadata.gz: 3ec5fe7e67a8718b893359293e5effc26ab0231dbb1140f9e7a3bcd27daaf595
+  data.tar.gz: 2843d0b8045b3a9792c8da5da2fcec973bf52a5157dd704ef7d42ac87ac2d057
 SHA512:
-  metadata.gz: 3c0f9e82106903a9aefda701fcaace4673a906e0712fcd4919e1499ad00917f1d3ec34657513e79ed3ecf1bc91cb2d4d37af3e212b47146d8f23c778d320f3bc
-  data.tar.gz: 72a190924d684c1856566756344633da3c7151ad6c6d38be3d2aee8e6e7390f054174d0f25b91f5dcc4fee966a4576940ae8e44881485b158f60ed6377c07be3
+  metadata.gz: d0b2674b2f1a89074cf8a07da2bf519bf9c3bec13b75b1162331b174dbf55386e4224d8167707a9d6febcebb61da7dd75e13eeeeda6eafc30b367d45619c20bd
+  data.tar.gz: 5cc9d3afc791fa9faa5e8c8aa27471404422dff3d5657ec99c1f030077ff49e184d08b075768caa6b1ca555bf520e3ee824a6b5233d006ef2841f5b9da81c8fd

data/bin/telescope

@@ -1,42 +1,34 @@
 #!/usr/bin/env ruby
 # encoding: utf-8
 @help = <<HELPTEXT
-Welcome to Telescope v0.2 - By Geir Isene (https://isene.com). This program is an aid for the amateur astronomer.
-It shows basic info about your telescopes and your eyepieces in combination with your telescopes.
-The top panel lists your telescopes with a set of properties. To add a telescope, press 't' and in the "command line"
-at the bottom enter a name, the apperature (APP) and the focal length (FL) of your telescope, then press ENTER. 
-The lower panel lists your eyepieces with properties for each telescope. To add an eyepiece, press 'e'. Enter a name,
-the focal length (FL) and apparent field of view (AFOV) and press ENTER.
-You can select the telescope and eyepiece panel by pressing TAB, and each element of a panel by the UP and DOWN cursor keys. 
-Upon selecting an item, press ENTER and change the values in the command line. Delete an item by pressing 'D'.
-Move an item up or down in a panel by pressing the PgUP or PgDown keys. Refresh all panels with the 'r' key.
-You can escape the selected panels or the command line by pressing 'Ctrl-G'. Quit via 'q' or 'Q' if you don't want to
-save your edits since last session. Telescope and eyepiece data is saved in the file '.telescope' in your home directory.
-Save a backup session with 'b' and load a previously saved backup session with the 'B' key.
+  WELCOME TO TELESCOPE - A TERMINAL/CONSOLE PROGRAM FOR THE AMATEUR ASTRONOMER.
+  The top panel lists your telescopes with eyepieces in the lower panel. Add a telescope by pressing 't' and fill in the name, the 
+  apperature (APP) and the focal length (FL) in the "command line" at the bottom and press ENTER. Add an eyepiece with 'e' and enter
+  a name, the focal length (FL) and apparent field of view (AFOV) and press ENTER. Select items by pressing TAB, then UP/DOWN cursor keys.
+  Press ENTER on a selected item to change the values in the command line. Delete an item by pressing 'D'. Move an with PgUP/PgDown keys. 
+  Tag items with the SPACE key (untag all with 'u'), then press 'o' to create an observation log file (content shown in the lower panel).
+  Refresh all panels with the 'r' key. Escape the selected panels or the command line by pressing 'Ctrl-G'. Quit via 'q' (or 'Q' if you 
+  don't want to save your edits since last session). Save a backup session with 'b' and load a saved backup session with the 'B' key.
+  Telescope and eyepiece data is saved in the file '.telescope' in your home directory (backup file is '.telescope.bu').
 
-LIST OF TELESCOPE ABBREVIATIONS:                                           LIST OF EYEPIECE ABBREVIATIONS:
-APP    = Apperature (in millimeters)                                       FL    = Focal Length (in millimeters)
-FL     = Focal Length (in millimeters)                                     AFOV  = Apparent Field Of View
-F/?    = Focal ratio (FL/APP)                                              xMAGN = Magnification (with that telescope)
-<MAG   = Maximum magnitude visible                                         FOV   = True Field Of View (deg/min/sec)
-xEYE   = Light gathering compared to the human eye                         XPUP  = Exit pupil (in millimeters)
-MINx   = Minimum usable magnification (may be lower for refractors)
-MAXx   = Maximum usable magnification
-*FIELD = Recommended magnification for star fields
-GX/NEB = Recommended magnification for galaxies and nebulae
-PL/GCL = Recommended magnification for planets and globular clusters
-PLd/2* = Recommended magnification for planet details and double stars
-TGHT2* = Recommended magnification for tight double stars
-DL-SEP = Minimum separation, Dawes limit
-RC-SEP = Minimum separation, Rayleigh limit
-MOON   = Minimum feature resolved on the Moon (in meters)
-SUN    = Minimum feature resolved on the Sun (in kilometers)
+  LIST OF TELESCOPE ABBREVIATIONS:                                                           LIST OF EYEPIECE ABBREVIATIONS:
+  APP, FL, F/? = Apperature and Focal Length (millimeters) and F-ratio                       FL     = Focal Length (in millimeters)
+  <MAG         = Maximum magnitude visible                                                   AFOV   = Apparent Field Of View
+  xEYE         = Light gathering compared to the human eye                                   xMAGN  = Magnification (with that telescope)
+  MINx, MAXx   = Minimum and maximum usable magnification                                    FOV    = True Field Of View (deg/min/sec)
+                                                                                             XPUP   = Exit pupil (in millimeters)
+  Recommended magnifications for objects:
+        *FIELD = star fields, GX/NEB = galaxies/nebulae, PL/GCL = planets/globular clusters 
+        PLd/2* = planet details/double stars, TGHT2* = tight double stars
+  DL/RC-SEP    = Minimum separation, Dawes limit and Rayleigh limit
+  MOON, SUN    = Minimum feature resolved on the Moon (meters) & Sun (kilometers)
 HELPTEXT
 begin # BASIC SETUP
   if `tput cols`.to_i < 140
     puts "You must run Telescope with a minimum tarminal width of 140 chracters."
   end
   require 'io/console'
+  require 'date'
   require 'curses'
   include  Curses
 
@@ -52,6 +44,9 @@ begin # BASIC SETUP
   
   @tsmark = false
   @epmark = false
+
+  @tstag = []
+  @eptag = []
 end
 if File.exist?(Dir.home+'/.telescope')
   load(Dir.home+'/.telescope')
@@ -60,6 +55,9 @@ class Numeric # NUMERIC CLASS EXTENSION
 	def deg
 	  self * Math::PI / 180 
   end
+  def dec2
+    "%.2f" % self
+  end
 end
 class Curses::Window # CLASS EXTENSION 
   # General extensions (see https://github.com/isene/Ruby-Curses-Class-Extension)
@@ -189,7 +187,7 @@ def main_getkey # GET KEY FROM USER
   when '?' # Show helptext in right window 
     @w_ep.clr
     @w_ep.pa(249, 0, 0, @help)
-    @w_ep.p("\n...Press any key to continue")
+    @w_ep.p("\n  ...Press any key to continue")
     getch
   when 'TAB'
     if @tsmark
@@ -290,6 +288,19 @@ def main_getkey # GET KEY FROM USER
     elsif @epmark
       @epmark = @ep.length - 1
     end
+  when ' '
+    if @tsmark
+      @tstag.include?(@tsmark) ? @tstag.delete(@tsmark) : @tstag.push(@tsmark)
+      @tsmark += 1 unless @tsmark == @ts.length - 1
+    elsif @epmark
+      @eptag.include?(@epmark) ? @eptag.delete(@epmark) : @eptag.push(@epmark)
+      @epmark += 1 unless @epmark == @ep.length - 1
+    end
+  when 'u'
+    @tstag.clear
+    @eptag.clear
+  when 'o'
+    observe
   when 'b'
     File.write(Dir.home+'/.telescope.bu',"@ts = #{@ts}\n@ep = #{@ep}")
   when 'B'
@@ -306,6 +317,62 @@ def main_getkey # GET KEY FROM USER
   else
   end
 end
+def observe
+  @tstag = @tstag.sort
+  @eptag = @eptag.sort
+  date = DateTime.now.strftime "%Y-%m-%d"
+  file = Dir.home + "/" + date + "_observation.txt"
+  obs  = "Observation file: #{file}\n"
+  obs += "Observation date:\n\n"
+  obs += "This file lists the intended equipment for the observation date.\n"
+  obs += "Reference observations with telescope letter and eyepiece numbers (like A2, B1, etc.)\n\n"
+  obs += "─" * 100 + "\n"
+  enum = "ABCDE"
+  @tstag.each_with_index do |t, i|
+    d    = @ts[t][1]
+    f    = @ts[t][2]
+    obs += "Telescope (#{enum[i]}): " + @ts[t][0].ljust(15) + " ("
+    obs += d.to_s + "mm/" + f.to_s + "mm f/" + (f/d.to_f).truncate(1).to_s + ")"
+    mag  = (5 * Math::log(d/10, 10) + 7.5).truncate(1).to_s
+    obs += "  Max MAG: " + mag
+    sepd = (115.824/d).truncate(2).to_s
+    sepr = (3600*Math::asin(671E-6/d)*180/Math::PI).truncate(2).to_s
+    obs += "  Min SEP: " + sepd + "/" + sepr + "\n"
+  end
+  obs += "No telescope(s) chosen for the observation\n" if @tstag.empty?
+  obs += "─" * 100 + "\n"
+  @eptag.each_with_index do |e, i|
+    m    = @ep[e][1]
+    a    = @ep[e][2]
+    obs += "Eyepiece  (#{i+1}): " + @ep[e][0].ljust(15) + " ("
+    obs += m.to_s.rjust(4) + "mm/" + a.to_s.rjust(3) + "°)  "
+    @tstag.each_with_index do |t, j|
+      d    = @ts[t][1]
+      f    = @ts[t][2]
+      obs += enum[j] + ": "
+      mag  = (f.to_f/m)
+      obs += mag.truncate(1).to_s.rjust(5) + "x ("
+      fov  = a/mag
+      deg  = fov.to_i
+      mins = ((fov - fov.to_i) * 60)
+      min  = mins.to_i
+      sec  = ((mins - min) * 60).to_i
+      deg == 0 ? dgo   =  "  " : dgo = deg.to_s + "°"
+      mno  = min.to_s.rjust(2, " ") + "'"
+      sco  = sec.to_s.rjust(2, " ") + "\""
+      obs += (dgo + mno + sco) + ")  "
+    end
+    obs += "\n"
+  end
+  obs += "No eyepiece(s) chosen for the observation\n" if @eptag.empty?
+  obs += "─" * 100 + "\n\n"
+  obs += "Object:              Equipment:               Observation:\n" * 8
+  @w_ep.clr
+  @w_ep.pa(255, 0, 0, obs)
+  @w_ep.p("\n...Press any key to continue")
+  File.write(file, obs)
+  getch
+end
 
 # TELESCOPE FUNCTIONS (top window,    w_ts) 
 def w_ts_show
@@ -322,38 +389,39 @@ def w_ts_show
     out  = " " + name.ljust(15)
     out += d.to_s.rjust(8)
     out += f.to_s.rjust(8)
-    @tsmark == i ? attr = Curses::A_BOLD | Curses::A_REVERSE : attr = Curses::A_BOLD
-    @w_ts.pa(254, 0, attr, out)
-    out  = (f.to_f/d.to_f).truncate(1).to_s.rjust(6)
+    attr = Curses::A_BOLD
+    attr = attr | Curses::A_REVERSE if @tsmark == i
+    attr = attr | Curses::A_UNDERLINE if @tstag.include?(i)
+    @w_ts.pa(254, 0, attr, out) # Basic info (Name, APP, FL)
     out  = (f.to_f/d.to_f).truncate(1).to_s.rjust(6)
-    @w_ts.pa(254, 0, 0, out)
+    @w_ts.pa(254, 0, 0, out)    # F/?
     out  = (5 * Math::log(d/10, 10) + 7.5).truncate(1).to_s.rjust(6)
-    @w_ts.pa(229, 0, 0, out)
+    @w_ts.pa(229, 0, 0, out)    # <MAG
     out  = (d**2/49).to_i.to_s.rjust(6)
-    @w_ts.pa(229, 0, 0, out)
+    @w_ts.pa(229, 0, 0, out)    # xEYE
     out  = magx(d, f, 1/7.to_f)
-    @w_ts.pa(194, 0, 0, out)
+    @w_ts.pa(194, 0, 0, out)    # MINx
     out  = magx(d, f, 2)
-    @w_ts.pa(194, 0, 0, out)
+    @w_ts.pa(194, 0, 0, out)    # MAXx
     out  = magx(d, f, 1/6.4)
-    @w_ts.pa(189, 0, 0, out)
+    @w_ts.pa(189, 0, 0, out)    # *FIELD
     out  = magx(d, f, 1/3.6)
-    @w_ts.pa(189, 0, 0, out)
+    @w_ts.pa(189, 0, 0, out)    # GX/NEB
     out  = magx(d, f, 1/2.1)
-    @w_ts.pa(189, 0, 0, out)
+    @w_ts.pa(189, 0, 0, out)    # PL/GCL
     out  = magx(d, f, 1/1.3)
-    @w_ts.pa(189, 0, 0, out)
+    @w_ts.pa(189, 0, 0, out)    # PLd/2*
     out  = magx(d, f, 1/0.7)
-    @w_ts.pa(189, 0, 0, out)
-    out  = (115.824/d).truncate(2).to_s.rjust(7)
-    @w_ts.pa(219, 0, 0, out)
-    out  = (3600*Math::asin(671E-6/d)*180/Math::PI).truncate(2).to_s.rjust(8)
-    @w_ts.pa(219, 0, 0, out)
+    @w_ts.pa(189, 0, 0, out)    # TGHT2*
+    out  = (115.824/d).truncate(2).dec2.to_s.rjust(7)
+    @w_ts.pa(219, 0, 0, out)    # DL-SEP
+    out  = (3600*Math::asin(671E-6/d)*180/Math::PI).truncate(2).dec2.to_s.rjust(8)
+    @w_ts.pa(219, 0, 0, out)    # RC-SEP
     moon = (384E6*Math::tan((Math::PI/180*115.824/d)/3600))
     out  = moon.to_i.to_s.rjust(6) + "m"
-    @w_ts.pa(225, 0, 0, out)
+    @w_ts.pa(225, 0, 0, out)    # MOON
     out  = (moon/2.5668).to_i.to_s.rjust(5) + "km"
-    @w_ts.pa(225, 0, 0, out)
+    @w_ts.pa(225, 0, 0, out)    # SUN
     @w_ts.p("\n")
   end
   @w_ts.clr_from_cur_line
@@ -390,7 +458,9 @@ def w_ep_show
     out  = " " + name.ljust(15)
     out += m.to_s.rjust(8)
     out += a.to_s.rjust(6) + "°"
-    @epmark == i ? attr = Curses::A_BOLD | Curses::A_REVERSE : attr = Curses::A_BOLD
+    attr = Curses::A_BOLD
+    attr = attr | Curses::A_REVERSE if @epmark == i
+    attr = attr | Curses::A_UNDERLINE if @eptag.include?(i)
     @w_ep.pa(253, 0, attr, out)
     @ts.each do |scope|
       d    = scope[1]
@@ -420,7 +490,7 @@ end
 # COMMAND FUNCTIONS   (bottom window, w_cm) 
 def w_cm_show
   @w_cm.fill
-  @w_cm.p(" Telescope v0.2 - By Geir Isene (https://isene.com)")
+  @w_cm.p(" Telescope v0.2 - By Geir Isene (https://isene.com) - press '?' to display the help text")
 end
 def w_cm_getstr(pretext, text) # A SIMPLE READLINE-LIKE ROUTINE
   Curses.curs_set(1)
@@ -496,7 +566,7 @@ loop do # OUTER LOOP - (catching refreshes via 'r')
     maxy = Curses.lines
     # Curses::Window.new(h,w,y,x)
     @w_ts = Curses::Window.new(7, maxx - 2, 1, 1)
-    @w_ep = Curses::Window.new(maxy - 10, maxx - 2, 9, 1)
+    @w_ep = Curses::Window.new(maxy - 10, maxx - 2, 8, 1)
     @w_cm = Curses::Window.new(1, maxx, maxy - 1, 0)
     @w_ts.fg, @w_ts.bg =  15,   0
     @w_ep.fg, @w_ep.bg = 255, 232

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: telescope-term
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: 0.5.2
 platform: ruby
 authors:
 - Geir Isene
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2021-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: curses
@@ -32,8 +32,8 @@ dependencies:
         version: 1.3.2
 description: 'With this program you can list your telescopes and eyepieces and get
   a set of calculations done for each scope and for the combination of scope and eyepiece.
-  Easy interface. Run the program, then hit ''?'' to show the help file. New in v0.2:
-  UI upgrade.'
+  Easy interface. Run the program, then hit ''?'' to show the help file. New in v0.5.2:
+  Minor fixes.'
 email: g@isene.com
 executables:
 - telescope