{"id":2488,"date":"2016-11-07T19:06:38","date_gmt":"2016-11-07T19:06:38","guid":{"rendered":"\/?post_type=ht_kb&p=2488"},"modified":"2021-03-10T01:25:10","modified_gmt":"2021-03-10T01:25:10","slug":"editing-caster-entries","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/editing-caster-entries\/","title":{"rendered":"Editing Caster Entries"},"content":{"rendered":"

When creating a new data stream (typically from a local serial data source) you must supply SNIP<\/strong><\/span> with certain basic data about the stream.\u00a0\u00a0 This article describes this process and how to use the Caster Table Data Entry<\/strong> dialog.<\/p>\n

Background<\/h3>\n

The data you provide will be used in the caster table entry for this mount point by your potential NTRIP clients.\u00a0 While\u00a0 you can in fact publish a data stream with a very incomplete caster table entry, speaking on a technical level this is poor practice and should be avoided.\u00a0 The dialogs and wizards provided by SNIP<\/strong><\/span> make this an easy process to complete. SNIP<\/strong><\/span> will remember the values you establish and use them with this stream thereafter.<\/p>\n

Aside<\/strong><\/span>:\u00a0 You only need to enter caster table details for caster table entries (mountPts) that you create<\/span>. You do not need to enter them for caster tables which you reuse from other NTRIP Casters (such as your remote-relay connections). SNIP<\/strong><\/span> will automatically gather these up for you and correctly place them in your local caster table.\u00a0 When you send a PUSH-out<\/strong> data stream to another caster, your local caster table entry is sent along with it automatically. When a new PUSH-in<\/strong> data stream first connects to your SNIP<\/strong><\/span> Caster, it either brings a suitable caster table with it or SNIP<\/strong><\/span> will create a suitable one for it.<\/p>\n

In the below, items with the term autoset<\/strong> <\/span><\/em>will be automatically set by SNIP<\/strong><\/span> for you if that stream is set to be parsed.<\/p>\n

The dialog<\/h3>\n

The key data itself entered in the Caster Table Data Entry<\/strong> dialog shown below.<\/p>\n

\"CasterTableDialog_r150\"<\/p>\n

The mountPt<\/h4>\n

The mountPt is the unique name you give this stream. Ideally it should be short and follow a consistent pattern such as four capital letters; but with >30k mountPts out there that is not easy to do.\u00a0 If your users will be typing on a PDA at least make it short for them (and that is one time a lower case name may be best).\u00a0 If you will have different data feeds from the same source (RTCM 2.3 and RTCM 3.x for example), you could add that to the name as well.\u00a0 As you look about you will see different networks use different patterns.\u00a0 Find one you like an try to follow it.\u00a0\u00a0 Remember: Case matters.<\/p>\n

It is the only required element in the entry. SNIP<\/strong><\/span> will ensure that it is unique if you were to set up multiple streams with the same names.<\/p>\n

City \/ State<\/h4>\n

This string can be used for a place name “My Town, My State” if you like, or left blank.\u00a0 It is optional.<\/p>\n

Country<\/h4>\n

This should be the three digit ISO-3166 code for the country the caster is located in. Here is a handy lookup table<\/a>\u00a0 for these codes. It is optional.<\/p>\n

Data Format<\/h4>\n

The precise type of data the stream has, used to tell the NTRIP Client what the data is, and therefore the Client can decide if it can decode and use it.\u00a0\u00a0 While this is also defined in the standard as free text, certain phrases (all in the drop down) are preferred.\u00a0 The various data formats supported by SNIP<\/strong><\/span> are further discussed in this article<\/a>. It is optional. It is autoset<\/strong> <\/span><\/em>if the stream is parsed.<\/p>\n

GNSS Type<\/h4>\n

The type(s) of GNSS data being sent in this stream, GPS, GLONASS, QZSS, Galileo, BeiDou (Compass), SBAS\/WASS, etc. It is optional. It is autoset<\/strong> <\/span><\/em>if the stream is parsed.<\/p>\n

Msg Types<\/h4>\n

A free form list of the message types found in the stream.\u00a0 Many times it can also have the data rates.\u00a0 Often this field is not correctly set or reflects message that are not in fact present.\u00a0 This is often true with RTCM 2.x data streams. \u00a0 It is optional. It is autoset<\/strong> <\/span><\/em>if the stream is parsed.\u00a0 When the messages are determined from parsing the stream, the initial set of values is used is gathered from the first ~120 seconds of operation.\u00a0 This is latter updated after the stream has been operational or ~15 minutes to remove any rounding in the message sending rates that may have occurred.<\/p>\n

Location (gross Latitude and Longitude)<\/h4>\n

The location of the data source to 0.01 degrees. It is used to help the client select which data source is closest to their rover device.\u00a0 In virtual reference station data streams this is often left as zero, zero. [The RTCM SC-104 recommends that the value be set to the middle of the service area rather than zero, zero.]\u00a0 It is optional. It is autoset<\/strong> <\/span><\/em>is the stream is parsed.<\/p>\n

In summary<\/h4>\n

So the shortest caster table entry one can have consists of just the unique mountPt name.\u00a0 SNIP<\/strong><\/span> will fill in the rest of the details when it can. Here is an example of a terse but valid caster stream for a mountPt called “Test”<\/p>\n

STR;Test;;;;;;SNIP;;0.00;0.00;1;;sNTRIP;;N;;;;<\/p>\n

 <\/p>\n

Using Local Defaults<\/h3>\n

The value for your city\/state string, your country string, and your lat-long location can be automatically filled in for a new empty stream if you first set these values in your preferences dialog.<\/p>\n

\n

But I am in a Hurry…<\/h3>\n

Proceed as follows:<\/p>\n

    \n
  1. Create a unique MountPt name to use; the hints will assist you with this.<\/strong><\/li>\n
  2. Leave the data format set to a blank value, indicating it is unknown.<\/li>\n
  3. Leave the GNSS type set to a blank value, indicating it is unknown.<\/li>\n
  4. Leave the lat-long set to 0,0\u00a0 (if the data is RTCM3 format and it is parsed, these will be filled in for you).<\/li>\n
  5. Leave the message types empty (f the data is RTCM3 format and it is parsed, these will be filled in for you after about ~120 seconds of observation time).<\/li>\n<\/ol>\n

    You are done. Hit return<\/strong>. Be sure to come back later and fix this (i.e. at least add the city\/state when the data comes from) when conditions allow.<\/p>\n

     <\/p>\n","protected":false},"excerpt":{"rendered":"

    When creating a new data stream (typically from a local serial data source) you must supply SNIP with certain basic data about the stream.\u00a0\u00a0 This article describes this process and how to use the Caster Table Data Entry dialog. Background The data you provide will be used in the caster […]<\/p>\n","protected":false},"author":13,"comment_status":"closed","ping_status":"open","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[284,112],"ht-kb-tag":[259,261,260],"class_list":["post-2488","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-snip-tabs-and-controls","ht_kb_category-general","ht_kb_tag-caster-entry","ht_kb_tag-caster-string","ht_kb_tag-edit-caster"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/2488","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=2488"}],"version-history":[{"count":15,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/2488\/revisions"}],"predecessor-version":[{"id":7634,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/2488\/revisions\/7634"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=2488"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=2488"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=2488"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}