Scripts/WME Validator/Custom Checks Discussion View history


Custom Checks Examples

Custom check is a powerful tool of WME Validator to highlight very specific map issues, not covered with built-in validations.

To set up a custom check in Validator click Settings->custom. There are two checks: green and blue. Each check has two fields: template and regular expression (RegExp).

Hover your mouse over the template field to get a tooltip with available variables. Validator substitutes those variables with segment's data and then tries to match that string over the RegExp. If the expanded template string matches the RegExp - Validator highlights the segment.

Template Variables

Most of the variables are self-explanatory. Note: empty address fields expand to empty streets, i.e. if you set "None" next to city name, then template "#${city}#" for this segment will be expanded to "##"

Road type: variable ${typeRank} expands to:

  • 1 for Runways
  • 2 for Railroads
  • ...
  • 14 for Major Highways
  • 15 for Freeways

Road direction: variable ${direction} expands to:

  • 0 for Unknown direction
  • 1 for A->B
  • 2 for B->A
  • 3 for Two-way segments

Regular Expressions (RegExp)

Regular expressions are patterns used to match character combinations in your expanded template. See the detailed description of regular expressions on MDN: link

Validator provides the following two extensions for regular expressions: Debug RegExp. To debug your RegExp add letter D at the very beginning: D/^[a-z]/ Validator will print debug information to the JavaScript console (Ctrl+Shift+J), so you can see how template variables expand for the segments on the map.

Negate RegExp. Sometimes it's much easier to create a RegExp for a normal condition and then just negate the result. To do so, add an exclamation mark at the very beginning: !/ (St|Ave)$/

Easy Examples

To highlight streets with word North Template: ${street} RegExp: /North/

To highlight invalid (null) elevations Template: ${elevation} RegExp: /null/

To highlight segments with no state assigned Template: ${state} RexExp: /^$/

To highlight segments with a U-turn Template: ${Uturn} RexExp: /1/

Medium Examples

To highlight Ramps with non-ground elevation: Template: ${typeRank}:${elevation} RegExp: /12:[^0]/

To highlight Freeways which do not start with letter A Template: ${typeRank}:${street} RegExp: /15:[^A]/

To highlight streets named "U-Turn" in LA Template: ${state}:${street} RegExp: /Louisiana:U-Turn/

To highlight dead-end U-turns Template: ${deadEnd}:${Uturn} RegExp: /1:1/

To highlight the opposite: missing dead-end U-turns Template: ${deadEnd}:${Uturn} RegExp: /1:0/

New! To highlight Freeways or Major Highways in format 'Axx', 'Ixx' etc Template: ${typeRank}:${street} RegExp: /^(15|14):[a-z][0-9]/i

New! To search for segments shorter than 17m: Template: ${length} RegExp: /^([0-9]|1[0-6])$/

New! To mark dead-ends without U-turn: Template: A${deadEndA}:${UturnA}:B${deadEndB}:${UturnB} RegExp: /A1:0|B1:0/

New! To highlight more than 100m long unnamed drivable streets: Template: ${drivable}:${street}:${length} RegExp: /1::...+/

Advanced Examples

To highlight street name which ends in Cntr, or Exd etc (any case variant) Template: ${street} RegExp: / (Cntr|Exd|La|Plc|Rvr|Tnpk|Wy)$/i

To highlight segments that have an alt street specified but no city Template: @@${altCity[0]}##${altStreet[0]}@@${altCity[1]}##${altStreet[1]} RegExp: /@@##[^@]/

To highlight invalid abbreviations for Australian roads Template: ${street} RegExp: !/ (Ave|Blvd|Cl|Cres|Cct|Ct|Dr|Way|Line|Ln|Mtwy|Pde|Pl|Rd|St)$|^$/

To highlight lowercase street names for US (except S, N, W, E and to) Template: ${street} RegExp: /^(?!(to) [^a-z])((S|N|W|E) )?[a-z]/

New! To highlight Freeways with no cardinal direction (NSEW) Template: ${type}:${street} RegExp: !/^[^3]| [NSEW]$/

New! City name abbreviation 'snt' should be lowercase and at the very beginning Template: ${city} RegExp: /(^|[ (])(?!^snt )[Ss][Nn][Tt]([ )]|$)/

New! To highlight segments if primary street name and one of the alt. names are the same Template: #${street}#${altStreet[#]}# RegExp: /(#.+)(?=#).*\1#/