Of Tags and Codes

Shawn Billings

Shawn Billings
5PLS
Tags control the connectivity of polylines. If you are not connecting polylines (using "Line" or "Curve" in the Collect>Action screen) Tags will be of no benefit, also there is no reason to export a Tag.

Codes (for the practicing land surveyor) best approximate a CAD layer. Codes also contain attributes defined by the user. These attributes allow for very specific information to be entered in the field along with very quick entry.

In this example of Codes I have several that have imported with CAD as well as a few that I've created in J-Field directly:

618__Select_Code_20141006-21.59.39.png


This is perhaps the most efficient way to develop your own codes. Begin by importing a dwg file with your personal layers (particularly those layers you use for collected data). Once imported, you can edit the individually created codes.
618__Import_From_DWG_DXF_20141006-22.08.24.png


Take care to check "Use Layer as Code" and "Create Missing Codes". This will create Codes from every layer in the imported drawing (whether used or not).

Once imported you can select a Code and edit its attributes.

618__Edit_Code_20141006-21.59.51.png


Here, you can see I've edited a Code named "Control". I created a category for it called "Collection" as this is a code I anticipate using while collecting points (rather than calculation). So I can use this for filtering the large number of codes visible by selecting this category from the Select Code list (see button at top right first slide above). I can explain what this code is in the Code Description and (in the future) assign a default symbol to this Code. The attributes I've created are Monument Type, Condition, Set By, Source. Of course these are my own, and you may find yourself wanting something else, but for me, this allows me to quickly specify the type of monument this control point is, the condition I found it in, who placed it, and what its source is (ie OPUS, HARN, etc.).

618__Attributes_Values_20141006-22.00.13.png

This is my current list for "Type". This list grows as I add more attributes in the editor as well as in the field while I'm collecting data based on my entry. Notice that I can very quickly select 1/2" IRON ROD for my monument type much faster than typing this value in. This is the case for all attributes. Type it once and it is available very quickly any time in the future.


Looking at another:
618__Edit_Code_20141006-22.00.27.png

Here I've created one for Boundary. You can see that this has the attributes pre-populated with my most commonly encountered boundary monument, a 1/2 inch rebar found in good condition. For my first attribute for "Found/Set" I have a list already created that includes "Found" and "Set". For Size, I have a list that contains 3/8", 1/2", 5/8", 3/4". As I add to these attributes the list grows. I can also delete attribute values that are no longer needed. For the Boundary code, I've preselected these values rather than <EMPTY> as shown on the Control code.

When exporting your data, you can select the output to something like:

618__Export_File_Format_20141006-22.47.07.png


This exports the name of the point, the N,E,H of the surveyed (not design) point, the Description of the point, the Code Name, the Attribute 1, 2, 3, 4 and 5. The plus signifies that exports will use Sep. 2 (separator 2) which I generally have set to space (rather than comma as shown). So a collected boundary point may look like this:

1,6835851.497,3100685.44,395.789,BP, BOUNDARY FOUND 1/2" IRON ROD NONE GOOD

Where 1 is the point name,
6835851.497 is the Northing
3100685.44 is the Easting
395.789 is the Elevation
BP is the description
BOUNDARY is the Code name
FOUND is attribute 1
1/2" is attribute 2
IRON ROD is attribute 3
NONE is attribute 4
GOOD is attribute 5

With the use of Codes, the description can be used more like a text note rather than containing action coding and point information. Tags can handle the issue of action coding required by other collectors but unnecessary to linework collection in J-Field, and Codes can be used specifically for point/line data. This data can be entered very quickly because of the libraries that are constantly growing and updating.

One of the great aspects of tags and codes in J-Field is that you can grow into them. Use descriptions for a while, then add Codes when it is convenient. Just add a white box for Codes and one for attributes. No need to radically change your experience.
 

Mikhail Drakin

Developer
One remark - when you import from DWG or DXF, only layers containing supported objects (points/polylines) are imported; empty layers are ignored at this point (probably we will change this in future).
 

Kelly Bellis

ME PLS 2099
5PLS
One remark - when you import from DWG or DXF, only layers containing supported objects (points/polylines) are imported; empty layers are ignored at this point (probably we will change this in future).
Hi Mikhail,
Could you please provide a sample seed file?
Thanks!
 

Kelly Bellis

ME PLS 2099
5PLS
Tags control the connectivity of polylines. If you are not connecting polylines (using "Line" or "Curve" in the Collect>Action screen) Tags will be of no benefit, also there is no reason to export a Tag.

Codes (for the practicing land surveyor) best approximate a CAD layer. Codes also contain attributes defined by the user. These attributes allow for very specific information to be entered in the field along with very quick entry.

In this example of Codes I have several that have imported with CAD as well as a few that I've created in J-Field directly:

View attachment 398

This is perhaps the most efficient way to develop your own codes. Begin by importing a dwg file with your personal layers (particularly those layers you use for collected data). Once imported, you can edit the individually created codes. View attachment 399

Take care to check "Use Layer as Code" and "Create Missing Codes". This will create Codes from every layer in the imported drawing (whether used or not).

Once imported you can select a Code and edit its attributes.

View attachment 400

Here, you can see I've edited a Code named "Control". I created a category for it called "Collection" as this is a code I anticipate using while collecting points (rather than calculation). So I can use this for filtering the large number of codes visible by selecting this category from the Select Code list (see button at top right first slide above). I can explain what this code is in the Code Description and (in the future) assign a default symbol to this Code. The attributes I've created are Monument Type, Condition, Set By, Source. Of course these are my own, and you may find yourself wanting something else, but for me, this allows me to quickly specify the type of monument this control point is, the condition I found it in, who placed it, and what its source is (ie OPUS, HARN, etc.).

View attachment 402
This is my current list for "Type". This list grows as I add more attributes in the editor as well as in the field while I'm collecting data based on my entry. Notice that I can very quickly select 1/2" IRON ROD for my monument type much faster than typing this value in. This is the case for all attributes. Type it once and it is available very quickly any time in the future.


Looking at another:
View attachment 401
Here I've created one for Boundary. You can see that this has the attributes pre-populated with my most commonly encountered boundary monument, a 1/2 inch rebar found in good condition. For my first attribute for "Found/Set" I have a list already created that includes "Found" and "Set". For Size, I have a list that contains 3/8", 1/2", 5/8", 3/4". As I add to these attributes the list grows. I can also delete attribute values that are no longer needed. For the Boundary code, I've preselected these values rather than <EMPTY> as shown on the Control code.

When exporting your data, you can select the output to something like:

View attachment 403

This exports the name of the point, the N,E,H of the surveyed (not design) point, the Description of the point, the Code Name, the Attribute 1, 2, 3, 4 and 5. The plus signifies that exports will use Sep. 2 (separator 2) which I generally have set to space (rather than comma as shown). So a collected boundary point may look like this:

1,6835851.497,3100685.44,395.789,BP, BOUNDARY FOUND 1/2" IRON ROD NONE GOOD

Where 1 is the point name,
6835851.497 is the Northing
3100685.44 is the Easting
395.789 is the Elevation
BP is the description
BOUNDARY is the Code name
FOUND is attribute 1
1/2" is attribute 2
IRON ROD is attribute 3
NONE is attribute 4
GOOD is attribute 5

With the use of Codes, the description can be used more like a text note rather than containing action coding and point information. Tags can handle the issue of action coding required by other collectors but unnecessary to linework collection in J-Field, and Codes can be used specifically for point/line data. This data can be entered very quickly because of the libraries that are constantly growing and updating.

One of the great aspects of tags and codes in J-Field is that you can grow into them. Use descriptions for a while, then add Codes when it is convenient. Just add a white box for Codes and one for attributes. No need to radically change your experience.

Shawn, any chance we could get something from you into the users guide? :rolleyes:
 

Mikhail Drakin

Developer
Kelly,
Please see attached a very simple seed file with edited block definition for code "Code1" - when you export point having code "Code1" (with respective options turned on), this point will use this block instead of "PointBlock" (other points will use "PointBlock" definition).
But it has nothing to do with code library - just a template file used for export. You prepare it yourself by exporting any arbitrary data and editing layers and block definitions (as described in help screen).
 

Attachments

  • seed.zip
    13.7 KB · Views: 430

Zoltan Varga

General Manager of Geomentor Kft
Hi Shawn,
I studied pages 183-189 of the Triumph-LS User Guide. It seems to me, if I want to draw more than one parcel line, than I have to create PAR1, PAR2, PARn tags. I know another software with which I can draw unlimited number of PAR lines in the same time while using only one "PAR" tag (they call it "code", not tag). When I am on the 1st point of the PAR1 line I select the "PAR" tag (code in that sw), and tap the Start Of Line button. This adds a number to the tag, starting from 1. So the tag of the first line will be PAR1. I can measure the next point on the PAR1 line, or measure the 1st point of the next PAR line. In the last case I select "PAR" tag and tap Start Of Line button again. The tag will be PAR2, and so on. This way I can start any PARx lines while I created only one PAR tag. If I am driwing (measuring) PAR4 line, and I want to continue the drawing of PAR1, than I tap the List Of Lines button, and select PAR1 line. This way I can jump from line to line. Of course the List Of Lines contains every other lines, not only the PARx lines, so I can select any line, e.g. PVM1 (for pavement).
What do you think about this ?
 

Zoltan Varga

General Manager of Geomentor Kft
Hi,
I understand that Javad want J-Filed not to look alike other software, but if the "code" is functioning like layer in AutoCAD, than why not call it "Layer" ? And if"Tag" functioning like codes in other softwares, then why not call it "Code" ? The present definitions are bothering.
 

Shawn Billings

Shawn Billings
5PLS
...if the "code" is functioning like layer in AutoCAD, than why not call it "Layer" ?
There are two reasons that the term layer was avoided. First, previous Javad collection software used Layer in a different context, more similar to the GIS understanding of Layers/Themes - basically what we call Pages now. The second reason is because Javad's Codes are more than CAD layers. Codes contain attributes and function more like feature codes in GIS than conventional data collector codes which often perform actions as well.

...Tag" functioning like codes in other softwares, then why not call it "Code" ?
Tags represent the name of geometries. Just as you have point names, tags are line names. Codes in other data collection software are often actionable (connecting geometries, drawing offsets, completing four sided figures, starting curves, ending curves, etc.). This is not necessary in J-Field as the linework is created in real time and the joining of linework to existing points can be done graphically. So, while codes in other software can function like Tags (EP1, EP2, EP3...), codes in other software also perform tasks that are not really necessary in J-Field. Furthermore, the use of the term "Code" to name geometries is not universal among all software. In some software, what we refer to as Tags would be called chains.

The present definitions are bothering.
There is an understood danger in introducing new terms in software. Using familiar terms lessens the learning curve and provides comfort to new users, while using new terms can be intimidating. However, if the software is doing something that is different from other software and uses the same term to describe it, then the argument will be "Layers in brand X do this, but Layers in J-Field do not do this." So there are times that it is better to depart from some terms (such as layers) and encourage the user to learn what the power of Pages and Codes are and discover how they can be used in place of CAD layers and do much, much more.
 

Zoltan Varga

General Manager of Geomentor Kft
At the moment I do not know "what the power of Pages and Codes are and how they can be used in place of CAD layers and do much, much more". I will do my best to understand this Tag/Code/Page thing in J-Field. Maybe this is hard to me because of the routine caused by the 10 years use of other softwares. What you wrote under "The present definitions are bothering" is true.
 
Top