telescope-term 0.2 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe9acb76c22f417d5ad5f68dd8c5e34f00dbe06d2d1d3147d3c4c155718d8e20
-  data.tar.gz: 1978de11b2f7d9ad85471ad025087db5ee4c7da050fc81fe8e42b5f9de4c6f74
+  metadata.gz: 4a3c05dde8a5ff611a62d0cfd72a5a811915d218b7af6cd977c14297396d8c31
+  data.tar.gz: f89a8414af71225d15d689d0cb1ea57b6669a0b67a43327e5e61e6c79754195d
 SHA512:
-  metadata.gz: b8fee3b2e553e25e13f7917f7de3d1acfde610b02b1dc48edc80b5507f741cdba598e6fa208d78cdbe8704dcb6b2047c98ab28819f25e278323bd8af6ca0d88d
-  data.tar.gz: e1391814eb3ff0c53b359c70cdf2a71ab56c6fadf23db979b356829557c31384aa729f471ae9d99de41a01056a174b48f04b4bd795e6d0e2ebbb9990cbf90a7d
+  metadata.gz: 17c083153fd29104fd907d5288247a6b5eb8b92db8eb8bc22692d725b89104c194ddc5aec27b7f515f411c5aec2f2560006151d131a229883d4baf3b0d42ea16
+  data.tar.gz: b268815b853c51df96d2d71fd1a4213cb52d4d14c06062ec212e6f06ebce7b47c77cec3f593c67dd5d3ffcba306914ef74e320c8017b5e9b71508ece97a2d1b2

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')
@@ -189,7 +184,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 +285,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 +314,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,10 +386,11 @@ 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
+    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)
     out  = (f.to_f/d.to_f).truncate(1).to_s.rjust(6)
-    out  = (f.to_f/d.to_f).truncate(1).to_s.rjust(6)
     @w_ts.pa(254, 0, 0, out)
     out  = (5 * Math::log(d/10, 10) + 7.5).truncate(1).to_s.rjust(6)
     @w_ts.pa(229, 0, 0, out)
@@ -390,13 +455,16 @@ 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]
       f    = scope[2]
       mag  = (f.to_f/m)
-      out  = mag.truncate(1).to_s.rjust(8)
+      @w_ep.pa(254, 0, 0, " │")
+      out  = mag.truncate(1).to_s.rjust(6)
       @w_ep.pa(156, 0, 0, out)
       fov  = a/mag
       deg  = fov.to_i
@@ -419,7 +487,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)
@@ -495,7 +563,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.2'
+  version: 0.5.1
 platform: ruby
 authors:
 - Geir Isene
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2021-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: curses
@@ -30,9 +30,10 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.2
-description: With this program you can list your telescopes and eyepieces and get
+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.
+  Easy interface. Run the program, then hit ''?'' to show the help file. New in v0.5.1:
+  Improved help text.'
 email: g@isene.com
 executables:
 - telescope