====== Highlight line of a particle trace ======

**What is a particle trace dataset?** \\
A particle trace dataset is an ASCII dataset (*.txt, *.csv, *XYZ file) imported into GeoScene3D as a XYZ Points object. Each point contains multiple attributes, as show in the example below:

  * X, Y, Z(required) - coordinates in GeoScene3D
  * ID (optional) - unique identification number of a set of points. Usually, this ID is used to represent a line that go through a set of points. A dataset can contain multiples lines with different unique IDs.
  * and more…

{{:geoscene3d:hydro_calculations:986e0b2ea0bec7a8d15071ad5f1c1085.png?460x310}}

----

Once a XYZ Points dataset is successful imported into GeoScene3D, see '[[:geoscene3d:add_points:xyzpoints|]]'. It is possible to show the line linking different set of points based on the attribute id, as shown below where a XYZ Points dataset with “Line Visible” option activated based on their ID visualized in 3D. \\
Note that the option "Separate Line Path Segments" is activated together with a valid value for the "Path ID Field".

{{:geoscene3d:hydro_calculations:c2a3e6d66c31caa9c9ff73f88af75aff.png?393x327}}

{{:geoscene3d:hydro_calculations:585317a60d4ac22f199b8ccd0b4e79c2.png}}

How to highlight a single line of a particle trace dataset based on a line ID? \\ {{:geoscene3d:hydro_calculations:5291693e84181e8b0f4d42138db0ffa0.png}} \\  \\ It is possible to highlight a single line based on a selected line ID in GeoScene3D. \\ The main idea is to make an extra copy of the current XYZ Points dataset, then apply a filter to removed unwanted lines. Then lastly apply different visualization styles to this copy to make it highlighted in different views. \\ This can be done through the following steps:

==== 1. Creating a highlight object ====

First at all, we create an object used to represent the highlight line in different views of GeoScene3D. This can be done easily by cloning the XYZ Points dataset. \\ In this example, this copy is then renamed to “Highlight”. \\ {{:geoscene3d:hydro_calculations:e0aaf244d92c2453bc59f3fbdf1447d8.png}}

==== 2. Limit line based on the line ID ====

After the “Highlight” object is created, we can now open the “Object properties…” window which allows us to limit the line visualization to only one line. This process can be done easily by using the slider “ID range” then click on the “Apply” button when the desired “ID value” is found. Note that the option “Line Visible” should be checked, together with “Separate Line Path Segments” and a valid “Path ID Field” attribute. The line limit will be applied to the “Highlight” object in all views of GeoScene3D (3D, 2D profile and 2D map window).\\
{{:geoscene3d:hydro_calculations:88e2d0f223b01f9976ded1376e6c08ed.jpg|88e2d0f223b01f9976ded1376e6c08ed.jpg}}

{{:geoscene3d:hydro_calculations:fcd848f940f7add822dec58849e89a91.png?322x370}}


==== 3. Highlight in 3D ====

We can now apply a new style for our “Highlight” object by changing the “Line Width” parameter, below the Line Width is 5. The highlight effect is done by modifying the “Line Width” of the “Highlight” object together with changing the transparency value of the original XYZ Points object. \\ {{:geoscene3d:hydro_calculations:bd73109ffebb6174988d850e04e71bfb.png}}{{:geoscene3d:hydro_calculations:8c06ff605b82c13af2c859b5b0f3bdce.png}} \\ {{:geoscene3d:hydro_calculations:f1e2cb05a00bdfb30c407aa041210c0b.png}}

==== 4. Highlight in profile view ====

The highlight effect in the profile view can be customized by changing the points style properties from the “Profile” tab of the “Object properties…” windows of our object “Highlight”. \\ In the exampel below the point sizes are 8. \\ {{:geoscene3d:hydro_calculations:01b04276fa0551f679fc12acdae2911f.png?299x394}}{{:geoscene3d:hydro_calculations:e415778c1aced026bb96663febedb212.png}}

==== 5. Highlight in map window ====

Once the “Highlight” object is added to the map window as an GeoScene3D object. The highlight effect, green dots in the map windows, can be done by changing the marker visual style from the map windows layer manager. \\  \\ {{:geoscene3d:hydro_calculations:1abd5f6a3c1678ff005d40dac89eca1e.png?375x459}}{{:geoscene3d:hydro_calculations:d2bb13d93a504512823e429c0371a1fc.png}}

==== How to highlight multiples lines? ====

For advanced user, there is a possibility to highlight more than one line. This is done through the “WHERE” filter of the “Tabular Dataset” properties. Below the two lines with the IDs 183 and 287 is highlighted. \\ Note that the option “Limit by ID” should be checked off when the “Tabular Dataset” limit is used. \\ {{:geoscene3d:hydro_calculations:15f412da7415ddd7d8f056ed75733764.png?300x406}}{{:geoscene3d:hydro_calculations:3245b455001167d4ed3a32dddeb01c70.png}}

==== Result ====

{{:geoscene3d:hydro_calculations:b12988ec02b8531c4bd0dd1e8da278d7.png}}