User Tools

Site Tools


en:coordinatedialog

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:coordinatedialog [2018/07/31 22:42] matze2en:coordinatedialog [2022/02/20 12:55] (current) – [Waypoint Calculator] Fix link lineflyer
Line 1: Line 1:
-FIXME **Note to translators: This page still needs improvement/corrections. Please do not start translation yet but only after this note is removed.** 
- 
 ====== Coordinate input dialog ====== ====== Coordinate input dialog ======
  
 {{:en:coordinput.png?direct&300 |}} {{:en:coordinput.png?direct&300 |}}
  
-The coordinate input dialog is opened if you click on the coordinate field while editing a [[cachedetails#waypoint_tab|waypoint]] or for entering coordinates in the [[.mainmenu:search|search]] or [[.mainmenu:goto|Go to]] menus.+The coordinate input dialog is opened if you tap on the coordinate field while editing a [[cachedetails#waypoint_tab|waypoint]] or for entering coordinates in the [[.mainmenu:search|search]] or [[.mainmenu:goto|Go to]] menus.
  
-The {{:abc_ic_clear_normal.png?nolink&40|}} button will close the dialog without changes, the {{:abc_ic_cab_done_holo_light.png?nolink&40|}} will close the dialog and save the changes.+The {{:ic_menu_cancel.svg?nolink&30|}} button will close the dialog without changes, the {{:ic_menu_done.svg?nolink&30|}} will close the dialog and save the changes.
  
 <WRAP center round tip 60%> <WRAP center round tip 60%>
Line 18: Line 16:
 {{:en:coordinput_format.png?nolink&300 |}} {{:en:coordinput_format.png?nolink&300 |}}
  
-By clicking on this field you can select between the different [[coordformat|supported coordinate formats]] or selecting ''Plain'' to manually input the desired format. The coordinate input fields will change their layout depending on your selection here.+By tapping on this field you can select between the different [[coordformat|supported coordinate formats]] or selecting ''Plain'' to manually input the desired format. The coordinate input fields will change their layout depending on your selection here.
  
 If you already entered coordinates these will be converted into the selected format. If you already entered coordinates these will be converted into the selected format.
Line 26: Line 24:
 {{:en:coordinput_coords.png?nolink&300 |}} {{:en:coordinput_coords.png?nolink&300 |}}
  
-Use these fields to enter the coordinates. By clicking on N/you can change to S/as needed.+Use these fields to enter the coordinates. By tapping on N/you can change to S/as needed.
  
 The layout of these input field depends on the coordinate format you selected above. The layout of these input field depends on the coordinate format you selected above.
Line 39: Line 37:
 |My coordinates|Will insert your current position into the coordinate fields.| |My coordinates|Will insert your current position into the coordinate fields.|
 |Cache coordinates|Will insert the cache listing coordinates into the coordinate fields.| |Cache coordinates|Will insert the cache listing coordinates into the coordinate fields.|
-|[[coordinatedialog#waypoint_calculator|Calculate coordinates]]|Will use the coordinates already entered above (optionally) and open the waypoint calculator.|+|[[.:waypointcalculator|Calculate coordinates]]|Will use the coordinates already entered above (optionally) and open the waypoint calculator.|
 |From clipboard|This button is only shown if your clipboard contains valid coordinates and will paste them into the coordinate fields.| |From clipboard|This button is only shown if your clipboard contains valid coordinates and will paste them into the coordinate fields.|
 |Clear coordinates|Empties the coordinate fields.| |Clear coordinates|Empties the coordinate fields.|
Line 46: Line 44:
 {{anchor:waypoint_calculator}} {{anchor:waypoint_calculator}}
  
-{{:en:coordinput_calculator.png?nolink&300 |}}  +The usage of the waypoint calculator is described in detail on [[.:waypointcalculator|this page of the user guide.]]
- +
-c:geo offers a calculator for waypoints, which allows to make use of variables and formulas to calculate coordinates based on the result. +
- +
-Once you clicked on ''Calculate Coordinates'' in the [[coordinatedialog#waypoint_sources|coordinate input dialog]] this screen will be shown. +
- +
-The {{:abc_ic_clear_normal.png?nolink&40|}} button will close the dialog without changes, the {{:abc_ic_cab_done_holo_light.png?nolink&40|}} will close the dialog, save the changes and return to the waypoint editor. +
- +
-<WRAP center round tip 60%> +
-You can use the calculator also for preparing your field trip by entering the needed variables and formulas but not yet entering values for your variables.\\ +
-This will of course not yet provide a valid result, but you can still save the current state at any time by saving your changes in the calculator and afterwards saving the waypoint state. +
-</WRAP> +
- +
-Clicking on the first field will open a drop down menu allowing to change between different coordinate formats as explained [[coordinatedialog#coordinate_format|here]]. All further functions are explained below. +
- +
-For easier understanding we will use an example of how the calculator can be used. +
- +
- +
-==== Main variable assignment ==== +
-{{anchor:main_variable_assignment}} +
- +
-{{ :en:calculator_coordinates.png?nolink&400 |}} +
- +
-By default this section will show the cache coordinates as a starting point for assigning your variables. +
- +
-By __short clicking__ on each digit you can cycle between the following functions for this specific digit: +
- +
-  * **Assigning a variable to this digit**\\ Will assign the next unused variable (A-Z) to this digit. +
-  * **Omit this digit**\\ Will remove this digit completely from the calculation. This will allow solutions with more than one digit in the neighboring variables. +
-  * **Return to the original state**\\ Will show the original value again. +
- +
-Furthermore you can __long click__ each digit to manually enter a number or variable. +
- +
-The result could look like this example: +
- +
-{{ :en:calculator_result_coord.png?nolink&400 |}} +
- +
-==== Main variable input ==== +
-{{anchor:main_variable_input}} +
- +
-<WRAP center round important 100%> +
-For the main variables you always have to use CAPITAL letters (A-Z), whereas for the sub variables (described further down) you always have to use lower case letters (a-z)! +
-</WRAP> +
- +
-The section below the coordinate field will show fields for all the main variables you assigned in the coordinate field. In our example it will look like this as we assigned four main variables (A,B,C,D): +
- +
-{{ :en:calculator_main.png?nolink&400 |}} +
- +
-You can now use these fields to assign a formula using sub variables (lower case a-z) to calculate the result for the main variables. +
- +
-The following operators are supported in these formulas: +
- +
-^ Operator ^ Function ^ Example ^ +
-|+|Addition|a+b| +
-|-|Subtraction|a-b| +
-|*|Multiplication|a*b| +
-|/|Division|a/b| +
-|%%^%%|Potentiate|a%%^%%b| +
-|%|Modulo|a%10| +
-|( )|Parenthesis|(a+b)*c| +
- +
-In our example, we use the following formulas for the main variables (as e.g. provided by the cache owner in the cache description) to continue: +
- +
-{{ :en:calculator_main_formulas.png?nolink&400 |}} +
- +
-==== Sub variable assignment ==== +
-{{anchor:sub_variable_assignment}} +
- +
-<WRAP center round important 100%> +
-For the sub variables you always have to use lower case letters (a-z), whereas for the main variables (described further above) you always have to use CAPITAL letters (A-Z)! +
-</WRAP> +
- +
-After assigning formulas to the main variables, an input field will be added automatically for each sub variable (lower case a-z) used in these formulas. +
- +
-These input fields can now be used to enter numeric values, which will then be used for automatic calculation of the result coordinates using the formulas providedYou can close and save the calculator state at any time now and return to the calculator to enter the next sub variable value as soon as you found it while doing your cache. +
- +
-<WRAP center round tip 100%> +
-Depending on the amount of main and sub variables you have to swipe the variable section to reach all input fields.\\  +
-You might also rotate your device into landscape mode to have all variables visible on your display. +
-</WRAP> +
- +
-In our example we did now find the values for a,b and c and entered them accordingly: +
- +
-{{ :en:calculator_sub_complete.png?nolink&400 |}} +
- +
-==== Result prediction ==== +
-{{anchor:result_prediction}} +
- +
-While you enter the formulas for the main variables and the values for the sub variables the result will be shown - on the fly in the result section. +
- +
-Digits not yet valid will be replaced by ''*'' and greyed out. Once the result produces valid coordinates the result field will be shown with all white characters. +
- +
-In our example a valid result is shown: +
- +
-{{ :en:calculator_result_final.png?nolink&400 |}} +
- +
-==== Calculator notes ==== +
-{{anchor:calculator_notes}} +
- +
-The last section in the calculator can be used to enter or paste notes, which can be helpful to e.g. copy parts of the cache description containing the calculations required to find the cache. +
- +
-The content of the calculator note will be synchronized to the note of the waypoint used to calculate. +
- +
-==== Using ''Plain'' Coordinate Format ==== +
-{{anchor:using_plain_coordinate_format}} +
- +
-Entering coordinates or coordinate formulas in //Plain// mode works completely different compared to the fixed formats. Instead of having a clickable field for each digit there are two free text fields to enter or copy the latitude and longitude part of a coordinate. +
- +
-Single digit or a group of digits can be replaced by a formula using variables that consist of capital letters surrounded with parenthesis. Often cache listings provide their waypoint coordinates already in the expected format. Therefore the plain mode is best suited when coordinate should be taken over "as is" from the listings. +
- +
-{{ :en:copy_waypoint_formulas.png?nolink&445 |}} +
- +
-The Plain mode works best with coordinates in [[coordformat|MinDeg format]] ''DDD° MM.MMM'''+
- +
-To enter the Plain mode change the "Coordinate format" to ''Plain''+
- +
-Taking the example in the screenshot above, copy the North part of the coordinate into the first (latitude) input field and the East part into the second (longitude). If the coordinate contains formulas with variables the corresponding variable input fields appear below. +
- +
-{{ :en:variable_input_fields.png?nolink&400 |}} +
- +
-The formula from the screenshot produces input fields for I, J, K, L, M and N. +
-You can fill the variable fields with values in the same way as with the fixed formats described above. +
- +
-As soon as the input for all variable fields is complete the result prediction usually turns into white and shows the calculated coordinate. +
- +
-{{ :en:result_prediction_ok.png?nolink&400 |}} +
- +
-In some cases the result field still stays gray because the coordinate parser could not interpret the initial coordinate input correctly. In the screenshot below there is a misplaced SPACE character between two digits of the same group which confuses the coordinate parser. +
- +
-{{ :en:result_prediction_fail.png?nolink&400 |}} +
- +
-Typical problems with coordinates copied from listings are: +
-  * lower case variable names; variables must consist of capital letters +
-  * space between digits within a group (N45° 5.(K) (I/N)(K+L+M+N)) +
-  * space before the degree sign (N45 ° 5.(K)(I/N)(K+L+M+N)) +
-  * space before the decimal point (N45° 5 .(K)(I/N)(K+L+M+N)) +
-  * space after the decimal point (N45° 5. (K)(I/N)(K+L+M+N)) +
-  * wrong minus sign: there are many different dash signs - only the standard hyphen/minus sign ("-") is accepted +
-  * wrong multiplication sign: sometimes an "x" or an interpunct ("·") is taken as multiplier sign instead of an asterisk ("*"+
-  * wrong division sign: sometimes a colon (":") is taken as division sign instead of a slash ("/"+
- +
-As with the other formats above the state of calculator can be saved at any time. +
- +
-==== Further information ==== +
-{{anchor:further_information} +
- +
-The contributor of the calculator code, published some videos presenting different usage examples for the calculator: +
- +
-{{youtube>eN2y5mvJul4?medium}} +
- +
-{{youtube>NlW2BfF-tu0?medium}} +
- +
-{{youtube>F-ZNAKbLCJ0?medium}} +
- +
-{{youtube>6_BALG5192A?medium}} +
- +
- +
en/coordinatedialog.1533069770.txt.gz · Last modified: 2018/07/31 22:42 by matze2