| Both sides previous revision Previous revision | |
| topodroidtherion [2019/02/10 09:54] – [TopoDroid] formatting brucemutton | topodroidtherion [2021/11/26 07:00] (current) – From TopoDroid to Therion website no longer exists. Updated for latest version of TopoDroid thilomuller |
|---|
| TopoDroid (like PocketTopo) is interactive and works with one data file at a time (it is just faster and easier this way while we are in a cave). However TopoDroid can produce data for post-processing optimised for either approach, interactive ‘single object’, or batch processed multiple objects. ie one huge sketch/scrap or many small sketches/scraps. | TopoDroid (like PocketTopo) is interactive and works with one data file at a time (it is just faster and easier this way while we are in a cave). However TopoDroid can produce data for post-processing optimised for either approach, interactive ‘single object’, or batch processed multiple objects. ie one huge sketch/scrap or many small sketches/scraps. |
| |
| Your use of TopoDroid and Therion will be most efficient and flexible if you consider the implications of this while you are sketching in the cave, and most especially before you export your data, ready to start working with Therion. | Your use of TopoDroid and Therion will be most efficient and flexible if you consider the implications of this while you are sketching in the cave, and most especially before you export your data, ready to start working with Therion. |
| | |
| | |
| ===Before using TopoDroid=== | ===Before using TopoDroid=== |
| |
| Firstly there are some differences in **terminology and concepts** between PocketTopo and Therion that deserve clarification. | There are some differences in **terminology and concepts** between PocketTopo and Therion that deserve clarification. |
| ^Therion ^TopoDroid ^ | | ^Therion ^TopoDroid ^ | |
| |Centreline |midline |generic word describing a set of survey legs| | |Centreline |midline |generic word describing a set of survey legs| |
| |
| |
| Secondly, **TopoDroid settings to make your Therion life easier**... | ===TopoDroid settings to make your Therion life easier=== |
| | |
| This is adapted from the TopoDroid documents website [[https://cd0920ff-a-62cb3a1a-s-sites.googlegroups.com/site/speleoapps/home/topodroid/docs/TopoDroid2Therion.pdf?attachauth=ANoY7cofXvNHRBERIaoLZlZWEOFkvOZednVyk1P2LPi-5IK5tfRYdetgi6SOG6aA1dEHmEctFl0O7OVM5W-xAZXSptNY8mNPB8cy6y8UE5K3XM-8zCYyOp-LG5mfZM4GmtRvFx47ZQDIKCiZXBMoYQ2oXNuL1n8urjDRY_qAKl9B2faOy1o7obyoCqwxja4RD6FKfscrppiZ-HBiEQ6_fNrTG3Jj8CDDJViMEu5Wh6cctJfW47939OUXp8s3l24iQEFxxlXye_Yk&attredirects=0|From TopoDroid to Therion]] | |
| |
| - The number of settings that are visible (and features that are enabled) depend on the Activity level that is set. \\ To see all of the settings mentioned below, you will need to select ‘advanced’ or higher. Navigate to menu SETTINGS **Activity Level** to check or adjust this setting. | - **Set Activity Level**. The number of settings that are visible (and features that are enabled) depend on the Activity level that is set. \\ To see all of the settings mentioned below, you will need to select ‘advanced’ or higher. Navigate to menu **SETTINGS -> Activity Level** to check or adjust this setting. |
| - Set **default export formats** to Therion for both data and sketches. \\ At the TopoDroid Main Window navigate to menu SETTINGS - IMPORT/EXPORT settings. \\ Default data export and sketch export are the first two settings. Set both of these to //Therion//. | |
| - While you are there, scroll down and, navigate to menu (SETTINGS - IMPORT/EXPORT) - //Therion//, and select whether you want point stations added automatically to Therion drawing th2 exports. Ticking this option will save you from having to create them manually using XTherion, although TopoDroid may not always do it perfectly. \\ If you have chosen an activity level of ‘advanced’ or higher, you will also see options to; \\ - put Therion map definitions before the survey data in .th files, \\ - to create splay lines in .th2 files (seems like a bad idea to me, better to export an xvi file as well/instead), \\ - to create estimated LRUD data at each station based on splay shots and, \\ - set a Therion drawing scale factor. \\ Choose these according to your preference. | - While you are there, scroll down and, navigate to menu (SETTINGS - IMPORT/EXPORT) - //Therion//, and select whether you want point stations added automatically to Therion drawing th2 exports. Ticking this option will save you from having to create them manually using XTherion, although TopoDroid may not always do it perfectly. \\ If you have chosen an activity level of ‘advanced’ or higher, you will also see options to; \\ - put Therion map definitions before the survey data in .th files, \\ - to create splay lines in .th2 files (seems like a bad idea to me, better to export an xvi file as well/instead), \\ - to create estimated LRUD data at each station based on splay shots and, \\ - set a Therion drawing scale factor. \\ Choose these according to your preference. |
| - Set the **scale factor applied to Therion and xvi sketch exports** (To change this, requires activity level set to expert). \\ From the TopoDroid Main Window, navigate to menu SETTINGS – IMPORT EXPORT – THERION – Therion Scale. \\ The default value is 100. A value of 200 results in th2 and xvi drawings that fit much better within the XTherion drawing editor zoom range of 25% to 400%. | - **Point Stations**. Set the scale factor applied to Therion and xvi sketch exports (To change this, requires activity level set to expert). \\ From the TopoDroid Main Window, navigate to menu **SETTINGS – IMPORT EXPORT – THERION – Therion Scale**. \\ The default value is 100. A value of 200 results in th2 and xvi drawings that fit much better within the XTherion drawing editor zoom range of 25% to 400%. |
| - Set the **Stations Policy**. This sets up the workflow that TopoDroid expects the Disto person to use when they arrive at a new survey station, and allows TopoDroid to name stations automatically. For example, ‘splays, forward leg’ matches the default PocketTopo workflow where first the splays are taken at a new station, then the forward survey leg is taken using three shots in a row. \\ From the TopoDroid Main Window, navigate to menu SETTINGS – SURVEY DATA, and make your selection. | - **Set the Stations Policy**. This sets up the workflow that TopoDroid expects the Disto person to use when they arrive at a new survey station, and allows TopoDroid to name stations automatically. For example, ‘splays, forward leg’ matches the default PocketTopo workflow where first the splays are taken at a new station, then the forward survey leg is taken using three shots in a row. \\ From the TopoDroid Main Window, navigate to menu **SETTINGS – SURVEY DATA**, and make your selection. |
| - It is recommended that you keep the **Loop closure** set to its default setting of ‘none’. (To check this, requires activity level set to expert, navigate to menu SETTINGS – SURVEY DATA – SHOT DATA – Loop closure). \\ It is better to be able to see loop misclosures in your field notes, save loop closure for Therion. | - **Loop closure**. It is recommended that you keep the Loop closure set to its default setting of ‘none’. To check this, requires activity level set to expert, navigate to menu **SETTINGS – CUSTOM SETTINGS - SURVEY DATA – SHOT DATA – Loop closure**. \\ It is better to be able to see loop misclosures in your field notes, save loop closure for Therion. |
| - Set the **line drawing style**. This has perhaps the most significant effect on the size and ease of handling and editing of your exported th2 files in XTherion. Navigate to menu SETTINGS – SKETCHING – LINES – line style, and select normal, coarse or bezier. \\ There are a number of approaches, which entail different compromises; \\ - //__Fine/normal/coarse__// all generate exported lines that have straight segments with no curvature. They tend to produce large files with very many line points that are difficult for XTherion to handle, and are difficult to edit once in XTherion, just due to the sheer number of points. You can reduce the number of points per line before export from TopoDroid with the decimation feature, or after export with the ‘simplify line’ feature in XTherion. Line segments are straight so it can look significantly different to your original sketch. XTherions ‘convert to curve’ feature can help here though. \\ - //__Bezier__// stores lines in the same way that smoothed lines are stored in Therion. Therefore you get curved/smoothed lines with an optimum (small) number of points that is easy for XTherion to load and easy(er) for you to edit. However if you erase part of a bezier line in TopoDroid, then it may erase a larger chunk than you would like. You can store lines of all four types in the same sketch file, but that is probably an awkward workflow. \\ There are also two settings that affect the Bezier line creation, ‘interpolation accuracy’ [1.0] and ‘bezier corner threshold’ [20]. | - **line drawing style**. This has perhaps the most significant effect on the size and ease of handling and editing of your exported th2 files in XTherion. Navigate to menu **SETTINGS – SKETCHING – LINES – line style**, and select normal, coarse or bezier. \\ There are a number of approaches, which entail different compromises; \\ - //__Fine/normal/coarse__// all generate exported lines that have straight segments with no curvature. They tend to produce large files with very many line points that are difficult for XTherion to handle, and are difficult to edit once in XTherion, just due to the sheer number of points. You can reduce the number of points per line before export from TopoDroid with the decimation feature, or after export with the ‘simplify line’ feature in XTherion. Line segments are straight so it can look significantly different to your original sketch. XTherions ‘convert to curve’ feature can help here though. \\ - //__Bezier__// stores lines in the same way that smoothed lines are stored in Therion. Therefore you get curved/smoothed lines with an optimum (small) number of points that is easy for XTherion to load and easy(er) for you to edit. However if you erase part of a bezier line in TopoDroid, then it may erase a larger chunk than you would like. You can store lines of all four types in the same sketch file, but that is probably an awkward workflow. \\ There are also two settings that affect the Bezier line creation, ‘interpolation accuracy’ [1.0] and ‘bezier corner threshold’ [20]. |
| - **Sketch (origin) station** When creating a new sketch, TopoDroid requests a 'station'. This is the origin station that is placed at (0,0) on the drawing page. You can read about this in the 'in-App help'. From the Help menu select the help book icon, then the .=== icon, then //15Index.SurveySketch.NewSketch// for details. Choosing the same 'station' for all your sketches may allow them to be aligned properly in XTherion (in future). \\ You can force TopoDroid to always suggest the same origin station. From the TopoDroid Survey Data Window, navigate to menu SETTINGS - Sketch Origin and tick 'Fixed sketch origin'. | - **Sketch (origin) station** When creating a new sketch, TopoDroid requests a 'station'. This is the origin station that is placed at (0,0) on the drawing page. You can read about this in the 'in-App help'. From the Help menu select the help book icon, then the .=== icon, then //15Index.SurveySketch.NewSketch// for details. Choosing the same 'station' for all your sketches may allow them to be aligned properly in XTherion (in future). \\ You can force TopoDroid to always suggest the same origin station. From the TopoDroid Survey Data Window, navigate to **SETTINGS - Sketch Origin and tick 'Fixed sketch origin'**. |
| - Surveys can be set up to have **‘station’ cross section sketches** either ‘private’ (specific to the sketch it is created in) or ‘shared’ (between all sketches in the survey session). This choice is made on creation of the survey, and it cannot be changed once the survey has been created. \\ This does not apply to ‘leg’ cross sections. These are always ''private/shared (?which?). [not sure if this is particularly relevant to how TopoDroid interfaces with Therion]'' | - **station cross section sketches**. Surveys can be set up to have ‘station’ cross section sketches either ‘private’ (specific to the sketch it is created in) or ‘shared’ (between all sketches in the survey session). This choice is made on creation of the survey, and it cannot be changed once the survey has been created. \\ This does not apply to ‘leg’ cross sections. These are always ''private/shared (?which?). [not sure if this is particularly relevant to how TopoDroid interfaces with Therion]'' |
| - You should only enable **drawing tools**/symbols that are supported by Therion. These are chosen via the Palette button in the TopoDroid Main Window. If you want, you can add Therion support for missing symbols by defining your own symbols with metapost. | - **drawing tools**. You should only enable drawing tools/symbols that are supported by Therion. These are chosen via the Palette button in the TopoDroid Main Window. If you want, you can add Therion support for missing symbols by defining your own symbols with metapost. |
| |
| ===Collecting TopoDroid Field Notes for Therion Projects=== | ===Collecting TopoDroid Field Notes for Therion Projects=== |