User:Kjg53/Interactive junction instruction algorithm View history

No edit summary
No edit summary
Line 83: Line 83:
|}
|}


<div class="interactive" id="01">Other than ''the origin'' and ''the destination'', are there any other segments connected to this junction?
<div class="step_by_step" id="01">Other than ''the origin'' and ''the destination'', are there any other segments connected to this junction?




Line 112: Line 112:


</div>
</div>
<div class="interactive" id="19">Do ''the origin'' and ''the destination'' meet at a [[Roundabouts/USA|Roundabout]]?
<div class="step_by_step" id="19">Do ''the origin'' and ''the destination'' meet at a [[Roundabouts/USA|Roundabout]]?




Line 140: Line 140:


</div>
</div>
<div class="interactive" id="02">Is the turn angle from ''the origin'' to ''the destination'' between {{:How_Waze_determines_turn_/_keep_/_exit_maneuvers/Turn threshold}} and 150°?
<div class="step_by_step" id="02">Is the turn angle from ''the origin'' to ''the destination'' between {{:How_Waze_determines_turn_/_keep_/_exit_maneuvers/Turn threshold}} and 150°?




Line 176: Line 176:


</div>
</div>
<div class="interactive" id="03">Which direction is the turn?
<div class="step_by_step" id="03">Which direction is the turn?




Line 201: Line 201:


</div>
</div>
<div class="interactive" id="04">Are there any other ''branches'' with unrestricted turns from ''the origin''?
<div class="step_by_step" id="04">Are there any other ''branches'' with unrestricted turns from ''the origin''?




Line 222: Line 222:


</div>
</div>
<div class="interactive" id="13">Is there more than one (1) {{H:title|Any segments other than the destination which leave the junction at an angle less than {{:How_Waze_determines_turn_/_keep_/_exit_maneuvers/Stay threshold}} will be referred to as other branches|
<div class="step_by_step" id="13">Is there more than one (1) {{H:title|Any segments other than the destination which leave the junction at an angle less than {{:How_Waze_determines_turn_/_keep_/_exit_maneuvers/Stay threshold}} will be referred to as other branches|
other branch}}?
other branch}}?


Line 244: Line 244:


</div>
</div>
<div class="interactive" id="14">Are the two branches (''the destination'' and the ''other branch'') ''overlapping''?
<div class="step_by_step" id="14">Are the two branches (''the destination'' and the ''other branch'') ''overlapping''?




Line 265: Line 265:


</div>
</div>
<div class="interactive" id="05">Is the name of ''the origin'' and ''the destination'' identical?
<div class="step_by_step" id="05">Is the name of ''the origin'' and ''the destination'' identical?




Line 286: Line 286:


</div>
</div>
<div class="interactive" id="06">Are ''the origin'' and ''the destination'' the same road type?
<div class="step_by_step" id="06">Are ''the origin'' and ''the destination'' the same road type?




Line 307: Line 307:


</div>
</div>
<div class="interactive" id="07">Are both the name AND the road type of any of the ''other branches'' identical to ''the origin''?
<div class="step_by_step" id="07">Are both the name AND the road type of any of the ''other branches'' identical to ''the origin''?




Line 328: Line 328:


</div>
</div>
<div class="interactive" id="08">Is there any ''other branch'' to the left of the destination branch?
<div class="step_by_step" id="08">Is there any ''other branch'' to the left of the destination branch?




Line 349: Line 349:


</div>
</div>
<div class="interactive" id="20">Is this an ''overlapping segment'', is it overlapped by any ''other branch''?
<div class="step_by_step" id="20">Is this an ''overlapping segment'', is it overlapped by any ''other branch''?




Line 370: Line 370:


</div>
</div>
<div class="interactive" id="25">Are the segments in a [[RHT|right hand traffic]] country (such as the USA)?
<div class="step_by_step" id="25">Are the segments in a [[RHT|right hand traffic]] country (such as the USA)?




Line 391: Line 391:


</div>
</div>
<div class="interactive" id="21">Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})
<div class="step_by_step" id="21">Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})




Line 412: Line 412:


</div>
</div>
<div class="interactive" id="22">Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})
<div class="step_by_step" id="22">Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})




Line 423: Line 423:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Left|NO => Exit Left]]'''
! scope="col" bgcolor="orangered" | '''[[#_Exit_Left|NO => Exit Left]]'''
|}
|}


Line 433: Line 433:


</div>
</div>
<div class="interactive" id="23">Is ''the origin'' a {{ramp}}?
<div class="step_by_step" id="23">Is ''the origin'' a {{ramp}}?




Line 454: Line 454:


</div>
</div>
<div class="interactive" id="24">Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?
<div class="step_by_step" id="24">Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?




Line 465: Line 465:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Left|NO => Exit Left]]'''
! scope="col" bgcolor="orangered" | '''[[#_Exit_Left|NO => Exit Left]]'''
|}
|}


Line 475: Line 475:


</div>
</div>
<div class="interactive" id="09">Is the name of any of the ''other branches'' identical to ''the origin''?
<div class="step_by_step" id="09">Is the name of any of the ''other branches'' identical to ''the origin''?




Line 496: Line 496:


</div>
</div>
<div class="interactive" id="10">Are ''the origin'' and ''the destination'' the same road type?
<div class="step_by_step" id="10">Are ''the origin'' and ''the destination'' the same road type?




Line 517: Line 517:


</div>
</div>
<div class="interactive" id="11">Is the name of any of the ''other branches'' identical to ''the origin''?
<div class="step_by_step" id="11">Is the name of any of the ''other branches'' identical to ''the origin''?




Line 538: Line 538:


</div>
</div>
<div class="interactive" id="12">Is the road type of any of the ''other branches'' identical to ''the origin''?
<div class="step_by_step" id="12">Is the road type of any of the ''other branches'' identical to ''the origin''?




Line 559: Line 559:


</div>
</div>
<div class="interactive" id="26">Are the segments in a [[LHT|left hand traffic]] country (like the UK)?
<div class="step_by_step" id="26">Are the segments in a [[LHT|left hand traffic]] country (like the UK)?




Line 580: Line 580:


</div>
</div>
<div class="interactive" id="15">Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})
<div class="step_by_step" id="15">Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})




Line 601: Line 601:


</div>
</div>
<div class="interactive" id="16">Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})
<div class="step_by_step" id="16">Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})




Line 623: Line 623:


</div>
</div>
<div class="interactive" id="17">Is ''the origin'' a {{ramp}}?
<div class="step_by_step" id="17">Is ''the origin'' a {{ramp}}?


{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
Line 643: Line 643:


</div>
</div>
<div class="interactive" id="18">Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?
<div class="step_by_step" id="18">Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?




Line 664: Line 664:


</div>
</div>
<div class="interactive" id="27">Are there five (5) or more segments ([[Glossary#Junction|junctions]]) connected to the roundabout?
<div class="step_by_step" id="27">Are there five (5) or more segments ([[Glossary#Junction|junctions]]) connected to the roundabout?


[[File:Abnormal roundabout 1.JPG|100px|border|more than 4 nodes]]
[[File:Abnormal roundabout 1.JPG|100px|border|more than 4 nodes]]
Line 672: Line 672:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" bgcolor="lawngreen" | '''[[#At the Roundabout Take the #xx Exit|YES => At the Roundabout Take the #xx Exit]]'''
! scope="col" bgcolor="lawngreen" | '''[[#_At the Roundabout Take the #xx Exit|YES => At the Roundabout Take the #xx Exit]]'''
|}
|}


Line 689: Line 689:


</div>
</div>
<div class="interactive" id="28">From the perspective of ''the origin'', are the ''roundabout angles'' to all the other segments between 0°-15°, or 75°-105°?
<div class="step_by_step" id="28">From the perspective of ''the origin'', are the ''roundabout angles'' to all the other segments between 0°-15°, or 75°-105°?




Line 700: Line 700:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" bgcolor="orangered" | '''[[#At the Roundabout Take the #xx Exit|NO => At the Roundabout Take the #xx Exit]]'''
! scope="col" bgcolor="orangered" | '''[[#_At the Roundabout Take the #xx Exit|NO => At the Roundabout Take the #xx Exit]]'''
|}
|}


Line 710: Line 710:


</div>
</div>
<div class="interactive" id="29">What direction is ''the destination'' relative to ''the origin''?
<div class="step_by_step" id="29">What direction is ''the destination'' relative to ''the origin''?




{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" | '''[[#At the Roundabout Turn Left|Left => At the Roundabout Turn Left]]'''
! scope="col" | '''[[#_At the Roundabout Turn Left|Left => At the Roundabout Turn Left]]'''
|}
|}


Line 721: Line 721:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" | '''[[#At the Roundabout Continue Straight|Straight => At the Roundabout Continue Straight]]'''
! scope="col" | '''[[#_At the Roundabout Continue Straight|Straight => At the Roundabout Continue Straight]]'''
|}
|}


Line 727: Line 727:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" | '''[[#At the Roundabout Turn Right|Right => At the Roundabout Turn Right]]'''
! scope="col" | '''[[#_At the Roundabout Turn Right|Right => At the Roundabout Turn Right]]'''
|}
|}


Line 733: Line 733:
{| border="1" cellpadding="10"
{| border="1" cellpadding="10"
|-
|-
! scope="col" | '''[[#At the Roundabout Make a U-Turn|U Turn, Back => At the Roundabout Make a U Turn]]'''
! scope="col" | '''[[#_At the Roundabout Make a U-Turn|U Turn, Back => At the Roundabout Make a U Turn]]'''
|}  
|}  
</div>
</div>
Line 740: Line 740:


== The navigation instructions ==
== The navigation instructions ==
<div class="interactive" id="_No_Instruction">
<div class="step_by_step" id="_No_Instruction">
=== No Instruction ===
=== No Instruction ===


Line 770: Line 770:


</div>
</div>
<div class="interactive" id="_Turn_Right">
<div class="step_by_step" id="_Turn_Right">
=== Turn Right ===
=== Turn Right ===


Line 793: Line 793:


</div>
</div>
<div class="interactive" id="_Keep/Stay_Right">
<div class="step_by_step" id="_Keep/Stay_Right">
=== Keep/Stay Right ===
=== Keep/Stay Right ===


Line 816: Line 816:


</div>
</div>
<div class="interactive" id="_Exit_Right">
<div class="step_by_step" id="_Exit_Right">
=== Exit Right ===
=== Exit Right ===


Line 843: Line 843:


</div>
</div>
<div class="interactive" id="_Turn_Left">
<div class="step_by_step" id="_Turn_Left">
=== Turn Left ===
=== Turn Left ===


Line 866: Line 866:


</div>
</div>
<div class="interactive" id="_Keep/Stay_Left">
<div class="step_by_step" id="_Keep/Stay_Left">
=== Keep/Stay Left ===
=== Keep/Stay Left ===


Line 889: Line 889:


</div>
</div>
<div class="interactive" id="�Exit_Left">
<div class="step_by_step" id="Exit_Left">
=== Exit Left ===
=== Exit Left ===


Line 917: Line 917:


</div>
</div>
<div class="interactive" id="�At_the_Roundabout_Take_the_.23xx_Exit">
<div class="step_by_step" id="_At_the_Roundabout_Take_the_.23xx_Exit">
=== At the Roundabout Take the #xx Exit ===
=== At the Roundabout Take the #xx Exit ===


Line 953: Line 953:


</div>
</div>
<div class="interactive" id="�At_the_Roundabout_Turn_Left">
<div class="step_by_step" id="_At_the_Roundabout_Turn_Left">
=== At the Roundabout Turn Left ===
=== At the Roundabout Turn Left ===


Line 977: Line 977:


</div>
</div>
<div class="interactive" id="�At_the_Roundabout_Turn_Right">
<div class="step_by_step" id="_At_the_Roundabout_Turn_Right">
=== At the Roundabout Turn Right ===
=== At the Roundabout Turn Right ===


Line 1,000: Line 1,000:


</div>
</div>
<div class="interactive" id="�At_the_Roundabout_Continue_Straight">
<div class="step_by_step" id="_At_the_Roundabout_Continue_Straight">
=== At the Roundabout Continue Straight ===
=== At the Roundabout Continue Straight ===


Line 1,023: Line 1,023:


</div>
</div>
<div class="interactive" id="�At_the_Roundabout_Make_a_U-Turn">
<div class="step_by_step" id="_At_the_Roundabout_Make_a_U-Turn">
=== At the Roundabout Make a U-Turn ===
=== At the Roundabout Make a U-Turn ===



Revision as of 00:44, 19 January 2015

This new page is currently undergoing modifications. The information and guidance is currently considered accurate enough to be followed now. Content is being prepared by one or more users. Do not make any changes before you send a private message to this user.

This is a clickable interactive guide to determine what instruction, if any, will be given at the junction between any 2 segments.

A text version of this information is available here.

There will eventually be encyclopedia style illustrations for all the various configurations to visually describe the setup.

Introduction

Understanding how and which instructions are provided requires first understanding a few concepts.

  • This page is discussing the instruction which will be provided by the Waze server (or not provided) when traveling from one segment, through a junction, and onto a second segment.
  • How Best Continuations work. Any time the destination segment is the Best Continuation there will not be an instruction provided.

While the illustrations displayed by each question may not represent every possible variation, they do represent the difference between the two options in that question. Please choose the most appropriate answer.

Definitions

  • ORIGIN: The segment you are on before going through the junction, in other words the segment you are coming from will be referred to as the origin, and corresponds to s-in in the the algorithm text provided by Waze staff.
    • In terms of navigation, the segment you are being routed from is the origin.
  • DESTINATION: The segment you will be on after the junction, in other words the segment you are going to will be referred to as the destination, and corresponds to s-out in the the algorithm text provided by Waze staff.
    • In terms of navigation, the segment you are being routed on to is the destination.
  • BRANCH: Any segments other than the destination which leave the junction at an angle less than 45.04° will be referred to as other branches, and corresponds to s-N, or s-1,2,3,4... in the the algorithm text provided by Waze staff.
  • OVERLAPPING: When the beginning portion two segments are directly on top of each other, meaning they both leave the junction at the exact same angle as each other, they will be referred to as an overlapping segment.
  • HIGHWAY: Any road typed in Waze as a  Freeway ,  Major Highway , or  Minor Highway , will be referred to in this page as a highway.
  • TURN ANGLE: The turn angle is the angle from the origin to the destination. A perfectly straight road with a junction in the middle would have a turn angle of 0°. The angle then gets wider as you turn to either side. A perfect left or right turn would be 90°. A U-turn at a junction between two segments would represent a 180° turn.
Turn Angles
Standard Turn Angle 37° Angle 90° Dogleg Geometry Node
  • NO-NAME Segments: A segment with no name (the "none" check-box for street name is checked) is considered to have "no-name" as a name for the Best Continuation algorithm. So two segments with no name, will be considered to have identical names, even if they would inherit different names for TTS.
  • ROUNDABOUT ANGLE: The Roundabout angle is the angle of any segment connected to the roundabout from the perspective of the origin. The actual turn angle of the segments is irrelevant.
    To explain;
    • Draw an imaginary line straight through the roundabout to the other side of the roundabout from junction node where the origin joins the roundabout. This will represent a 0° Roundabout angle, any deviation to the right or left will increase the angle.
    • Draw another imaginary line across the roundabout exactly perpendicular to the first imaginary line. This will represent a 90° Roundabout angle to either side.
    • For more info see the roundabouts page
Roundabouts
Normal Non-Normal

All other segments are within the allowed ±15° from either 0° or 90°. Not all other segments are within the allowed ±15° from either 0° or 90°.
The allowed range for roundabouts may actually be less than ±15°, this is currently being tested.

Directions

To use this interactive flowchart;

  • Start with the first question in The Interactive Algorithm.
  • Click on the appropriate answer which best matches your situation. A new question will jump to the top of the screen
  • Continue answering the questions until an instruction is displayed at the top of the screen.
  • This is the instruction that the Waze server should give when transversing this junction between the two segments you described as the origin and the destination.
As of September 2014 This algorithm was changed to also factor in alternate names. This algorithm is still correct when none of the segments have alternate names. If there are alternate names on any of the segments there are a few modifications (in bold).
  • The order of preference for Best Continuation is;
  1. Primary name + Type match
  2. Alt name + Type match
  3. Primary name match, OR Primary name <=> Alt name Cross-match
  4. Alt name match
  5. Type match
  • City names have no affect on matches.

A Cross-match is when the primary name of one segment is identical to the alternate name of an adjacent segment. It had the same priory as a Primary name match.

  • In order for a Cross match to work there must be at least one alt name on both involved segments (even though they don't necessarily match each other).
  • It will work even if the are no Primary names on those segments.
  • It will not work if all three segments at a split have a matching Primary name or a matching Alternate name.

An Alt match is when two adjacent segments have an identical alternate name (regardless of city name).

  • It will not work if all three segments at a split have a matching Primary name.
  • It will work even the OUT segment (the one leaving the split) has no Primary name.
Bring up comments or questions on this page in this forum .
~PesachZ (PM [Help])  

The interactive algorithm

(01)
Other than the origin and the destination, are there any other segments connected to this junction?


intersection At Grade Connector At Grade Connector

YES


dead end cul-de-sac dead end continue junction turn junction


NO => No Instruction



(19)
Do the origin and the destination meet at a Roundabout?


Round about street round about MH mH round about ramps

YES


intersection bowtie

NO



(02)
Is the turn angle from the origin to the destination between 45.14° and 150°?


YES


NO, the turn angle is less 45.04°


NO, the turn angle is greater than 150°
SPECULATION NOTE: This is unconfirmed Turns with angles greater than 150° will follow the same instruction path as 45.14°-150°, but the Waze routing server will penalize this turn, and avoid routing through it.



(03)
Which direction is the turn?


Left => Turn Left


Right => Turn Right



(04)
Are there any other branches with unrestricted turns from the origin?


YES


NO => No Instruction



(13)
Is there more than one (1)

other branch?


YES


NO



(14)
Are the two branches (the destination and the other branch) overlapping?


YES => No Instruction


NO



(05)
Is the name of the origin and the destination identical?


YES


NO



(06)
Are the origin and the destination the same road type?


YES


NO



(07)
Are both the name AND the road type of any of the other branches identical to the origin?


YES


NO => No Instruction



(08)
Is there any other branch to the left of the destination branch?


YES


NO



(20)
Is this an overlapping segment, is it overlapped by any other branch?


YES


NO



(25)
Are the segments in a right hand traffic country (such as the USA)?


YES


NO => Keep/Stay Right



(21)
Is the origin a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES


NO



(22)
Is the destination a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES => Keep/Stay Left


NO => Exit Left



(23)
Is the origin a  Ramp ?


YES


NO => Keep/Stay Left



(24)
Is the destination a highway ( Freeway ,  Major Highway , or  Minor Highway ), or a  Ramp ?


YES => Keep/Stay Left


NO => Exit Left



(09)
Is the name of any of the other branches identical to the origin?


YES


NO => No Instruction



(10)
Are the origin and the destination the same road type?


YES


NO



(11)
Is the name of any of the other branches identical to the origin?


YES


NO



(12)
Is the road type of any of the other branches identical to the origin?


YES


NO => No Instruction



(26)
Are the segments in a left hand traffic country (like the UK)?


YES


NO => Keep/Stay Left



(15)
Is the origin a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES


NO



(16)
Is the destination a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES => Keep/Stay Right


NO => Exit Right



(17)
Is the origin a  Ramp ?
YES


NO => Keep/Stay Right



(18)
Is the destination a highway ( Freeway ,  Major Highway , or  Minor Highway ), or a  Ramp ?


YES => Keep/Stay Right


NO => Exit Right



(27)
Are there five (5) or more segments (junctions) connected to the roundabout?

more than 4 nodes not normal angles more than 4 nodes

YES => At the Roundabout Take the #xx Exit


4 nodes

NO



(28)
From the perspective of the origin, are the roundabout angles to all the other segments between 0°-15°, or 75°-105°?


YES


NO => At the Roundabout Take the #xx Exit



(29)

The navigation instructions

No Instruction

There will be No instruction given passing through this junction. This can be caused by several factors including

  • Best Continuation
  • Certain cases with an overlapping segment
  • The instruction would be Continue Straight (this doesn't yet exist in the client application)


Displayed Icons
Livemap
& WME
Client App
Not
Available
in Client
App







Turn Right

Displayed Icons
Livemap
& WME
Client App







Keep/Stay Right

Displayed Icons
Livemap
& WME
Client App







Exit Right

Displayed Icons
Livemap
& WME
Client App


NOTE:
  • In a left hand traffic country this instruction does not exist, and will instead give a Keep/Stay_Right instruction.
  • You will only get an Exit instruction on a turn angle less than 45.04°, because it is assumed no true exit would have a turn sharper than 45.04°.






Turn Left

Displayed Icons
Livemap
& WME
Client App







Keep/Stay Left

Displayed Icons
Livemap
& WME
Client App







Exit Left

Displayed Icons
Livemap
& WME
Client App


NOTE:
  • In a right hand traffic country this instruction does not exist, and will instead give a Keep/Stay_Left instruction.
  • You will only get an Exit instruction on a turn angle less than 45.04°, because it is assumed no true exit would have a turn sharper than 45.04°.







At the Roundabout Take the #xx Exit

The "#xx" will be 1st, 2nd, 3rd, etc.. The counting starts from the origin.


Displayed Icons
Livemap
& WME
Client App

NOTE: In the client app there will be a digit inside the circle representing which number exit you must take (starting from the origin).

If the roundabout is not formed correctly (more than one entering/exiting segment connected to same roundabout node), you may get an instruction "at the roundabout, exit number 0" with a partial verbal instruction.







At the Roundabout Turn Left

Displayed Icons
Livemap
& WME
Client App








At the Roundabout Turn Right

Displayed Icons
Livemap
& WME
Client App







At the Roundabout Continue Straight

Displayed Icons
Livemap
& WME
Client App







At the Roundabout Make a U-Turn

Displayed Icons
Livemap
& WME
Client App

NOTE: Currently this is only displayed in the client, but there is no verbal instruction (due to a bug).























this space intentionally left blank