gps_pvt 0.8.4 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39089e2daa55491ccf086809797c2fef68d1e0268e75e6217ed793f091e748de
-  data.tar.gz: cca39a3dbcca26921606019be603526f62766c841a92191ee0a99174f00b54c7
+  metadata.gz: e9977db11c202c0e16e0db9a06a91419011732835f8d406194f4663342e79eef
+  data.tar.gz: 485793ee595d5245e383f70de03efd77f98f1e4228ba74b782c80fb2d0e06946
 SHA512:
-  metadata.gz: becc6540b82ff9d3a97b4b6c5e58f2a7b0872f63584abdee2c425860e1c47b07700f778550ab95bccb3fc7b6462f9fb2f6249ca7846d1a9a9319471e96577c55
-  data.tar.gz: 67b2b12b88df52a19e84ef68a7773f2ec989dec3858b5d64e0e60961f8f9f4154eda3e36ef1548b61004c8af4cc6b6850ba73c145f15da41832944857c904889
+  metadata.gz: ee59dd138de2243ea47a170c8d0724803fb3a5e19b28b5fe360649614c827b020000dc264dfd810b48346cfb3ddd0929925633d9769848a782ee6c65feeb0143
+  data.tar.gz: 63230d1fee5eadb80487df64d679300144a457efaaa6f9874a6574bb600c47307f4cedab607385d9bfd73a5c43e0e066f22ee09ccd0b81a6294d688c753d3e08

data/README.md

@@ -32,7 +32,7 @@ An attached executable is useful. After installation, type
 
     $ gps_pvt file_or_URI(s)
 
-The format of file is automatically determined with its extension, such as .ubx will be treated as UBX format. A compressed file of .gz or .Z can be specified directly (decompression is internally performed). URI such as http(s)://... and ftp://, and serial port (COMn for Windows and /dev/tty* for *NIX, version >= 0.8.0) are also acceptable. Moreover, Ntrip URI of ntrip://(username):(password)@(caster_host):(port)/(mount_point), for exmaple, ```ntrip://test%40example.com:none@rtk2go.com:2101/NAIST-UBX``` (%40 is recognized as '@') is supported (version >= 0.8.4). If you want to specify the file format, instead of file_or_URI(s), use the following arguments:
+The format of file is automatically determined with its extension, such as .ubx will be treated as UBX format. A compressed file of .gz or .Z can be specified directly (decompression is internally performed). URI such as http(s)://... and ftp://, and serial port (COMn for Windows and /dev/tty* for *NIX, version >= 0.8.0) are also acceptable. Moreover, Ntrip URI of ntrip://(username):(password)@(caster_host):(port)/(mount_point), for exmaple, ```ntrip://test%40example.com:none@rtk2go.com:2101/NAIST-UBX``` (%40 is recognized as '@') is supported (version >= 0.8.4), and its content format can be automatically determined (version >= 0.9.0). If you want to specify the file format, instead of file_or_URI(s), use the following arguments:
 
 | specification | recoginized as |
 ----|----
@@ -42,6 +42,7 @@ The format of file is automatically determined with its extension, such as .ubx
 | --sp3=file_or_URI | [Standard Product 3 Orbit Format](https://files.igs.org/pub/data/format/sp3c.txt) (supported gps_pvt version >= 0.6.0) |
 | --antex=file_or_URI | [Antenna Exchange Format](https://igs.org/wg/antenna#files) (supported gps_pvt version >= 0.6.0) |
 | --rinex_clk=file_or_URI | [RINEX clock](https://files.igs.org/pub/data/format/rinex_clock304.txt) file (supported gps_pvt version >= 0.7.0) |
+| <a name=opt_rtcm3>--rtcm3=file_or_URI</a> | [RTCM 10403.x](https://rtcm.myshopify.com/collections/differential-global-navigation-satellite-dgnss-standards), ephemeris and MSM7 are used. (supported gps_pvt version >= 0.9.0) |
 
 Since version 0.2.0, SBAS and QZSS are supported in addition to GPS. Since version 0.4.0, GLONASS is also available. QZSS ranging is activated in default, however, SBAS is just utilized for ionospheric correction. GLONASS is also turned off by default. If you want to activate SBAS or GLONASS ranging, "--with=(system or PRN)" options are used with gps_pvt executable like
 
@@ -150,19 +151,31 @@ receiver.solver.correction = { # provide by using a Hash
 
 ## Additional utilities
 
-### [to_ubx](exe/to_ubx)
+### [gps2ubx](exe/gps2ubx) <sub>(formerly [to_ubx](../../tree/v0.8.4/exe/to_ubx))</sub>
 
 Utility to convert observation into u-blox ubx format and dump standard input. After installation of gps_pvt, to type
 
-    $ to_ubx file_or_URI(s) (options) > out.ubx
+    $ gps2ubx file_or_URI(s) (options) > out.ubx
 
-saves resultant into out.ubx by using redirection. The shared options with gps_pvt executable are [rinex_obs](#opt_rinex_obs), [rinex_nav](#opt_rinex_nav), [ubx](#opt_ubx), and [online_ephemeris](#opt_online_ephemeris). In addition, the following options are available.
+saves resultant into out.ubx by using redirection. The shared options with gps_pvt executable are [rinex_obs](#opt_rinex_obs), [rinex_nav](#opt_rinex_nav), [ubx](#opt_ubx), [rtcm3](#opt_rtcm3) and [online_ephemeris](#opt_online_ephemeris). In addition, the following options are available.
 
 | key | value | comment | since |
 ----|----|----|----
 | ubx_rawx |  | Change output packet types to UBX-RAWX from its default UBX-RAW. | v0.8.1 |
 | broadcast_data |  | In addition to observation, ephemeris is inserted by using UBX-SFRB packets. If ubx_rawx option is specified, UBX-SFRBX is used instead of UBX-SFRB. | v0.8.1 |
 
+### [gps_get](exe/gps_get)
+
+Utility to get and dump GPS files. After installation of gps_pvt, to type
+
+    $ gps_get file_or_URI(s) (options) > output_file
+
+saves data into output_file by using redirection. http(s), ftp, and ntrip can be used as scheme of URI. Serial port is also supported. Note that compressed data is automatically decompressed before output. The following options are available.
+
+| key | value | comment | since |
+----|----|----|----
+| out | file | Change output target from the standard output. In addition to file, serial port is supported. | v0.8.5 |
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake` to build library and run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/exe/{to_ubx → gps2ubx}

@@ -9,14 +9,15 @@ require 'gps_pvt/ubx'
 
 $stderr.puts <<__STRING__
 Usage: #{__FILE__} GPS_file ... > as_you_like.ubx
-As GPS_file, only rinex_obs(*.YYo) is currently supported.
+As GPS_file, rinex_obs(*.YYo) and rtcm3 stream are supported.
 (YY = last two digit of year)
 File format is automatically determined based on its extention described in above parentheses.
 If you want to specify its format manually, command options like --rinex_obs=file_name are available.
 Supported RINEX versions are 2 and 3.
 RXM-RAWX and RXM-SFRBX are included in output UBX if corresponding file(s) is given. 
 A file having additional ".gz" or ".Z" extension is recognized as a compressed file.
-Major URL such as http(s)://... or ftp://... is acceptable as an input file name. 
+Major URL such as http(s)://... or ftp://... is acceptable as an input file name.
+Ntrip specified in URI as ntrip://(username):(password)@(caster_host):(port)/(mount_point) is also supported, and its format is automatically detected. 
 __STRING__
 
 options = []
@@ -41,16 +42,16 @@ files.collect!{|fname, ftype|
   when /\.\d{2}[nhqg](?:\.gz)?$/; :rinex_nav
   when /\.\d{2}o(?:\.gz)?$/; :rinex_obs
   when /\.ubx$/; :ubx
-  else
-    raise "Format cannot be guessed, use --(format, ex. rinex_obs)=#{fname}"
   end
   fname = proc{
     next fname if File::exist?(fname)
     if uri = URI::parse(fname) and !uri.instance_of?(URI::Generic) then
+      ftype ||= uri.read_format if uri.instance_of?(URI::Ntrip)
       next uri
     end
     raise "File not found: #{fname}"
   }.call
+  raise "Format cannot be guessed, use --(format, ex. rinex_obs)=#{fname}" unless ftype
   [fname, ftype]
 }
 
@@ -101,6 +102,7 @@ files.each{|fname, ftype|
   case ftype
   when :ubx; rcv.parse_ubx(fname){}
   when :rinex_obs; rcv.parse_rinex_obs(fname){}
+  when :rtcm3; rcv.parse_rtcm3(fname){}
   end
 }
 

data/exe/gps_get

@@ -0,0 +1,70 @@
+#!/usr/bin/env ruby
+
+require 'gps_pvt/util'
+require 'uri'
+
+$stderr.puts <<__STRING__
+Usage: #{__FILE__} file_or_URI(s) ...
+This utility outputs GNSS data specified with file_or_URI(s).
+A file_or_URI having additional ".gz" or ".Z" extension is recognized as a compressed file, and the decompression is performed before output.
+In addition to a local file, major URIs such as http(s)://..., ftp://..., and ntrip:// are supported.
+Serial port (COMn for Windows, /dev/tty* for *NIX) is also acceptable as an input file name.
+__STRING__
+
+options = []
+
+files = ARGV.collect{|arg|
+  next arg unless arg =~ /^--([^=]+)=?/
+  k, v = [$1.downcase.to_sym, $']
+  options << [$1.to_sym, $']
+  nil
+}.compact
+
+spec2io = proc{
+  io_pool = {}
+  proc{|spec, mode_r|
+    mode_r = true if (mode_r == nil)
+    next (io_pool[spec] ||= open(spec)) if Serial::SPEC =~ spec # serial port
+    if (uri = (URI::parse(spec) rescue nil)) and !uri.instance_of?(URI::Generic) then # URI
+      if mode_r then
+        case uri
+        when URI::Ntrip; next URI::open(uri)
+        else; next GPS_PVT::Util::get_txt(uri)
+        end
+      end
+      raise "Unknown URI: #{spec}"
+    end
+    if mode_r then # file
+      next STDIN if spec == '-'
+      next open(GPS_PVT::Util::get_txt(spec), 'r') if File::exist?(spec)
+      raise "File not found: #{spec}"
+    else
+      next STDOUT if spec == '-'
+      open(spec, 'a+')
+    end
+  }
+}.call
+
+STDIN.binmode
+STDOUT.binmode
+dst, io_dst = proc{|spec| [spec, spec2io.call(spec, false)]}.call('-')
+
+options.reject!{|k, v|
+  case k
+  when :out
+    dst, io_dst = [v, spec2io.call(v, false)]
+    next true
+  end
+  false
+}
+raise "Unknown option: #{options.first}" unless options.empty?
+
+$stderr.puts "out: #{{'-' => '(stdout)'}[dst] || dst}"
+threads = files.collect{|src|
+  $stderr.puts "in: #{{'-' => '(stdin)'}[src] || src}"
+  io_src = spec2io.call(src)
+  Thread.start{
+    io_dst.write(io_src.read(128)) until io_src.eof?
+  }
+}
+threads.each{|t| t.join}

data/exe/gps_pvt

@@ -11,10 +11,11 @@ As GPS_file, rinex_nav(*.YYn, *.YYh, *.YYq, *.YYg), rinex_obs(*.YYo), ubx(*.ubx)
 (YY = last two digit of year)
 File format is automatically determined based on its extention described in above parentheses.
 If you want to specify its format manually, command options like --rinex_nav=file_name are available.
-Other than --rinex_nav, --rinex_obs, -rinex_clk, --ubx, --sp3 or --antex are supported. 
+Other than --rinex_nav, --rinex_obs, --rinex_clk, --ubx, --sp3, --antex or --rtcm3 are supported. 
 Supported RINEX versions are 2 and 3.
 A file having additional ".gz" or ".Z" extension is recognized as a compressed file.
-Major URL such as http(s)://... or ftp://..., and serial port (COMn for Windows, /dev/tty* for *NIX) is acceptable as an input file name.
+Major URI such as http(s)://... or ftp://..., and serial port (COMn for Windows, /dev/tty* for *NIX) is acceptable as an input file name.
+Ntrip specified in URI as ntrip://(username):(password)@(caster_host):(port)/(mount_point) is also supported, and its format is automatically detected.
 __STRING__
 
 options = []
@@ -24,7 +25,7 @@ misc_options = {}
 files = ARGV.collect{|arg|
   next [arg, nil] unless arg =~ /^--([^=]+)=?/
   k, v = [$1.downcase.to_sym, $']
-  next [v, k] if [:rinex_nav, :rinex_obs, :ubx, :sp3, :antex, :rinex_clk].include?(k) # file type
+  next [v, k] if [:rinex_nav, :rinex_obs, :ubx, :sp3, :antex, :rinex_clk, :rtcm3].include?(k) # file type
   options << [$1.to_sym, $']
   nil
 }.compact
@@ -75,17 +76,17 @@ files.collect!{|fname, ftype|
   when /\.sp3(?:\.Z)?$/; :sp3
   when /\.atx(?:\.Z)?$/; :antex
   when /\.clk$/; :rinex_clk
-  else
-    raise "Format cannot be guessed, use --(format, ex. rinex_nav)=#{fname}"
   end
   fname = proc{
     next fname if File::exist?(fname)
     next fname if ((fname =~ Serial::SPEC) rescue false)
     if uri = URI::parse(fname) and !uri.instance_of?(URI::Generic) then
+      ftype ||= uri.read_format if uri.instance_of?(URI::Ntrip)
       next uri
     end
     raise "File not found: #{fname}"
   }.call
+  raise "Format cannot be guessed, use --(format, ex. rinex_nav)=#{fname}" unless ftype
   [fname, ftype]
 }
 
@@ -140,5 +141,6 @@ files.each{|fname, ftype|
   case ftype
   when :ubx; rcv.parse_ubx(fname)
   when :rinex_obs; rcv.parse_rinex_obs(fname)
+  when :rtcm3; rcv.parse_rtcm3(fname)
   end
 }