{"id":4897,"date":"2024-12-07T00:12:55","date_gmt":"2024-12-07T00:12:55","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=4897"},"modified":"2024-12-07T19:25:53","modified_gmt":"2024-12-07T19:25:53","slug":"pfat-filter-dialog-controls","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-filter-dialog-controls\/","title":{"rendered":"PFAT: Filter Dialog Controls"},"content":{"rendered":"<p style=\"padding-left: 30px;\">The <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/introducing-pfat\/\">PFAT features<\/a> are available in the <span style=\"color: #993300;\"><strong><em>Pro<\/em><\/strong>, and <strong><em>Basic<\/em><\/strong>,<\/span> editions of <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>.\u00a0 <span style=\"color: #993300;\"><strong><em>Lite<\/em><\/strong> <\/span>copies of <span style=\"color: #0000ff;\"><strong>SNIP<\/strong> <\/span>share the same code base, but many of these innovative features are disabled in the freely available <span style=\"color: #993300;\"><strong><em>Lite<\/em><\/strong> <\/span>edition.<\/p>\n<h3><strong>Using the PFAT Filter Dialog Controls<\/strong><\/h3>\n<p>The Filter Dialog is shown below.\u00a0 A detailed review of the Filter controls settings follows.\u00a0 The general uses of message filtering in PFAT is discussed in <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/pfat-filter-settings-and-uses\/\">this article<\/a>.\u00a0\u00a0 The Filter Msgs Dialog can be invoked on any parsed stream by right-clicking the streams content menu, of by clicking on the Filter icon in the PFAT display dialog.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-4895\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled.png\" alt=\"\" width=\"839\" height=\"738\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled.png 839w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled-300x264.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled-768x676.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled-50x44.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled-600x528.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_DialogLabeled-320x281.png 320w\" sizes=\"auto, (max-width: 839px) 100vw, 839px\" \/><\/p>\n<p>The window can resized as needed when there is a longer list of filtered messages.<\/p>\n<h4><strong>The MountPt<\/strong><\/h4>\n<p>The MountPt (the name of the stream which is being filtered) is shown in the window title.<\/p>\n<h4><strong>Master On\/Off<\/strong><\/h4>\n<p>This check box enables or disables the use of filtering in this stream.\u00a0 When disabled, the messages selected to be filtered are kept in the list but are not used.\u00a0 This supports an easy method of switching filtering on or off without having to reenter the list of messages again.<\/p>\n<h4><strong>Pre selection Groups<\/strong><\/h4>\n<p>These radio buttons provide a simple means to change the state of all the check boxes for all messages <em>en masse<\/em>.<\/p>\n<h4><strong>Individual Messages Types<\/strong><\/h4>\n<p>Each message has its own check box to <em>enable<\/em> or <em>disable<\/em> filtering it.\u00a0 The count value shows how many messages have been decoded since parsing was last restarted.\u00a0 The <strong>Adj<\/strong> cell is not used at this time.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-4900\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/02\/pfat_Filter_OneItem.png\" alt=\"\" width=\"318\" height=\"38\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/02\/pfat_Filter_OneItem.png 318w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/02\/pfat_Filter_OneItem-300x36.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/02\/pfat_Filter_OneItem-50x6.png 50w\" sizes=\"auto, (max-width: 318px) 100vw, 318px\" \/><\/p>\n<h4><strong>ToolTip Use<\/strong><\/h4>\n<p>A tool tip with the formal name of each message is displayed when the user hovers over the message type (MT) cell.<\/p>\n<p><span style=\"font-size: 18px;\"><strong>Broadcast Orbit<\/strong><\/span><\/p>\n<p>A button has been added (from <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Rev 3.17 onward) that will automatically add all the Broadcast Orbital messages to the filtering list.\u00a0 This is useful to quickly filter out such messages (MT1019, MT1020, etc.) from the stream.\u00a0 Many GNSS base stations will periodically send these messages, often when a new SV first appears over the horizon. This are not of any value to the rover devices (they already have their own copy), but increase bandwidth needed and hence the chance of a message error and re-transmission.<\/p>\n<h4><strong>Status Label<\/strong><\/h4>\n<p>The status label is updated at a ~1Hz rate and briefly reflects any changes made.\u00a0 The local time and a count of all messages received by this data stream are displayed.<\/p>\n<h4><strong>Ok \/ Cancel Buttons<\/strong><\/h4>\n<p>The Ok button accepts the edits, installs them in the filter and closes the dialog.<br \/>\nThe Cancel button discards any edits and closes the dialog, making no changes.<\/p>\n<p>&nbsp;<\/p>\n<hr \/>\n<h4><\/h4>\n<h4><b>Add a Filter to remove Broadcast Orbital Messages<\/b><\/h4>\n<p>Added in <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> <strong>Rev 3.17<\/strong> is a new convenience button marked <strong>Add BCast Orbits<\/strong>, that adds a set of filters for all the Broadcast Orbital messages in a single button click.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-9200 size-full\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl.png\" alt=\"\" width=\"549\" height=\"308\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl.png 549w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl-300x168.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl-50x28.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2024\/12\/NewPFAT_FilterControl-320x180.png 320w\" sizes=\"auto, (max-width: 549px) 100vw, 549px\" \/><\/a><\/p>\n<p>Because the rover device (the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\" target=\"_blank\" rel=\"noopener\">NTRIP Client<\/a>) is receiving these messages directly, they have almost no use when being send over NTRIP.\u00a0 They do waste bandwidth and they increase the statistical likelihood of a message failure and re-transmission events.\u00a0 Hence, is the customary to not send them.\u00a0 But many Base Station configurations default to sending such messages, especially when a new SV first rises over the horizon and is newly tracked.\u00a0 \u00a0Use PFAT Filtering and this button to easily remove such messages.<\/p>\n<p>&nbsp;<\/p>\n<hr \/>\n<h3><\/h3>\n<h3><strong>Adding a New Message Type\u00a0 <\/strong><\/h3>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-4894 alignright\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_AddMsgDialog.png\" alt=\"\" width=\"440\" height=\"240\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_AddMsgDialog.png 440w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_AddMsgDialog-300x164.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_AddMsgDialog-50x27.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/pfat_Filter_AddMsgDialog-320x175.png 320w\" sizes=\"auto, (max-width: 440px) 100vw, 440px\" \/><\/p>\n<p>It is easy to select and filter message types which are present in the stream when the Filter dialog is open.\u00a0 But what about adding a message that is not currently displayed in the stream?<\/p>\n<p>The Add New Message Button is used for this.\u00a0 When pressed, a secondary dialog appears as shown below. \u00a0\u00a0This dialog allows adding a filter for any valid message type (MT) found in the RTCM3 standard.\u00a0 This includes private messages, experimental messages, and MTs have not yet been defined by RTCM SC-104.<\/p>\n<p>&nbsp;<\/p>\n<p><span style=\"color: #008000;\"><strong>Note:<\/strong><\/span> At this time only the RTCM 3.x message types (MT) are supported by PFAT filtering. (Support for RTCM 2.x messages is planned).<\/p>\n<h4><strong>Message ID:<\/strong><\/h4>\n<p>The Message ID is set by a spin box, used to select the value of the desired MT value.<\/p>\n<p>The bold text line below the Message ID value is the formal name of the RTCM3.x message, the same as is used in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/an-rtcm-message-cheat-sheet\/\">RTCM3 cheat sheet<\/a> page.<\/p>\n<p>The text box below that provides commentary on the general use of the message, using the same text found in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/rtcm-3-message-list\/\">RTCM3 message list<\/a>, the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/an-rtcm-message-cheat-sheet\/\">cheat sheet<\/a> web pages, and <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> itself.<\/p>\n<h4><strong>Use:<\/strong><\/h4>\n<p>To add a new message type, simply set the spin box to the desired value and press <strong>Ok<\/strong>.<\/p>\n<p>Pressing <strong>Cancel<\/strong> exits the dialog without make any changes or additions.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The PFAT features are available in the Pro, and Basic, editions of SNIP.\u00a0 Lite copies of SNIP share the same code base, but many of these innovative features are disabled in the freely available Lite edition. Using the PFAT Filter Dialog Controls The Filter Dialog is shown below.\u00a0 A detailed [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[334],"ht-kb-tag":[399,381],"class_list":["post-4897","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-advanced-topics","ht_kb_tag-message-filters","ht_kb_tag-pfat"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4897","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=4897"}],"version-history":[{"count":14,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4897\/revisions"}],"predecessor-version":[{"id":9207,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4897\/revisions\/9207"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=4897"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=4897"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=4897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}