====== Alignment Flow Diagram ======

This page documents the flow diagram for doing alignments in the Android apps.

{{ :android:alignment.png?nolink |}}

The **BLUE** paths are for //any app//.

The **GREEN** path is for //SmartDirt// and //SmartPlan//.

The **WHITE** paths are for //SmartGrade// and depend on the context:  

  * **Any Mode** - if you Do or Don't have recovery data, but you DO have BM's you can shoot in BM's.  
  * **New Survey** and **New Measure** - a default location of 5000,5000,100 is used with the current location to create a default 1-pt alignment (no scaling and no rotation).
  * **New Measure** - If you have recovery data but no BM's, then a default 1-pt alignment is done.  Note the oddity of this context because it is really ONLY for continuing a New Measure so the user can do something like stop for lunch without having to shoot in BM's.

Note that there appears to be two paths for shooting in BM's.  The difference in the paths is the method used to create a default alignment __so that the user can see their location **BEFORE** actually doing the alignment__.  If no recovery data exists then the user will **NOT** be able to see themselves on the screen until **AFTER** shooting in the //first BM//. If there is recovery data, then an initial 2-pt recovery will be done so that the user can see where they are on the screen before shooting in BM's.

In the center of the image are 3 paths for 1-pt alignment.  The **pick pt** path is also known as //Put Me Here//.  **Use mid-pt** is when no alignment data exists at all yet there is data in the file. It is really just a way to show the user on the site so they can then do a //Put Me Here//. **Use 5k,5k,100** is for when we are creating a new file (New Survey and New Measure).