encoding utf-8 #FILENAME: thconfig-TemplateComprehensive.thc #! CAVE SURVEY: MAP & 3D MODEL COMPILATION #===================================================== #Edited Bruce Mutton 19 Mar 2012 Improve self documentation #INSTRUCTIONS #============ #This is a template you can use as a basis for Therion thconfig (compilation) script. #This one is somewhat comprehensive and is intended for a cave that is say over 10km long or has # many detailed drawings in multiple projections. #Use your text editors 'Find and Replace' to replace all instances of with the name of # the cave or system. This file is best viewed with a plain text editor that can 'style' the fonts # based on the syntax - makes the syntax stand out from the comments... #Comment or uncomment particular lines by adding or removing the # symbol. #SOURCE DATA FILES #================= # These are the files that contain or point to the survey network, map objects and surfaces # ./ = current folder ../ = parent of current folder source INDEX.th #survey source INDEXPlan.th #plan drawings source INDEXElev290.th #drawings looking magnetic west source INDEXElev020.th #drawings looking magnetic north source ../../Surface/SurfaceArea.th #terrain image and model #SELECT SURVEYS AND OR MAP OBJECTS #================================= # List the specific surveys and or map objects that you wish to export. # If no surveys are selected, then 'survey type exports' will include ALL surveys in 'sources'. # If no map objects are selected, then 'map object type exports' will include ALL map objects in # 'sources'. # Surveys and map object selections are independant, the selections and outputs of one type have # NO EFFECT on the other (ver 5.3.6), so there is no need to comment out plans if you only want # elevations # For this reason, unless all (or no) maps and surveys are selected, reported statistics for the # different outputs almost always differ from each other. ##PLANS select PlanMap # the whole cave, defined in INDEXPlan.th ##Examples of subset or specialist maps # select PlanMap #defined in INDEXPlan.th # select PlanMap #defined in INDEXPlan.th ##Special Set of Atlas Plan Chapters## ##order of selects is order of bookmarks/hyperlinks in Atlas, so call from top down ##REMEMBER to uncomment appropriate LayoutAtlasThisCavePlan.thc variant below # select CelebrationGimlisInletsPlanMap #defined in INDEXPlan.th... # select CelebrationShelobsTowersGimlisPlanMap # select CelebrationNotTowersPlanMap # select CelebrationElfsDenPlanMap # select SmaugsBilbosLoopPlanMap ##End of Celebration Set of Atlas Plan Chapters ##Chronology Atlas Plan Chapters## ##order of selects is order of bookmarks/hyperlinks in Atlas, so call youngest first ## assuming recent is previewed above and older is previewed below ##REMEMBER to uncomment appropriate LayoutAtlasThisCavePlan.thc variant below # select 2012-PlanMap #defined in INDEXPlan.th... # select 2009-2011PlanMap # select 1995-2008PlanMap # select 1983-1994PlanMap # select 1979-1982PlanMap # select 1974-1978PlanMap ##End of Chronology Atlas Plan Chapters ##ElEVATIONS select Elev020Map # the whole cave, defined in INDEXElev020Map.th ##Examples of subset or specialist maps select Elev020Map # from INDEXElev290.th select Elev290Map # the whole cave, defined in INDEXElev290Map.th # I think you get the idea now... #INPUT FILES #=========== # make other files, generally layouts, available as though typed herein... use relative paths # Layouts affect 2D outputs only input ../../StdFiles/LayoutStandards.thc #generic settings to be consistent across all outputs input ../../StdFiles/LayoutAtlasPaperSizes.thc #pre-defined landscape and portrait page setups input ../../StdFiles/LayoutScales.thc #pre-defined settings to suit output scales input ../../StdFiles/LayoutStatisticsReporting.thc input LayoutAnnotation.thc #contains any map-comments to concatinate specific to this cave input LayoutMapThisCave.thc #'cave wide' map settings input LayoutMapThisCavePlan.thc #plan specific page layout, surface display etc input LayoutMapThisCaveElev290.thc #elevation290 specific page layout etc input LayoutMapThisCaveElevEXT.thc #extended elev specific page layout etc input LayoutAtlasThisCave.thc #'cave wide' atlas settings ## Choose ONE of the following Layout...Plan files ## dependant on your choice of selects above and exports below input LayoutAtlasThisCavePlan.thc #generic plan specific paper size, page excl for general atlas # input LayoutAtlasThisCavePlan-Celebration-A3Landscape1000.thc #ditto for specific atlas # input LayoutAtlasThisCavePlan-Chronology-A2Landscape5000.thc #ditto for specific atlas input LayoutAtlasThisCaveElev290.thc #elevation290 specific paper size, page exclusions etc input LayoutAtlasThisCaveElev020.thc #elevation020 specific paper size, page exclusions etc # input LayoutAtlasThisCaveElevEXT.thc #ext elev specific paper size, page exclusions etc layout LayoutEnterExperimentalVersionDate #check and enter the current therion version each time you compile until this feature is code tex-map \newtoks\thversion \thversion={5.3.9} % #use {} to hide compile version and date in header endcode copy LayoutExperimentalHeader #from LayoutStandards: sets up for acceptance of LayoutEnterExperimentalVersionDate endlayout LayoutEnterExperimentalVersionDate #SPECIFY OUTPUT COORDINATE SYSTEM #================================= # Recommended if you have one or more coordinate systems defined in source surveys or surfaces # Often required if you also export to atlas # Choose coordinate systems that are relevant to the cave locations! # cs EPSG:2193 #NZ Transverse Mercanter 2000 cs EPSG:27200 #NZ Map Grid 1949 #EXPORTS #======= # This is where you define what TYPE of output you want # 'Titles' of map objects and or surveys, if specified, are often included in outputs # Textural outputs are fast to export and less sensitive to data errors, so produce these first. # Models without drawing outlines are next, then maps. # (Deactivate/Activate the following outputs by # commenting/uncommenting lines below as appropriate) # see end of file for common export options #TEXT/DATA OUTPUTS #=================+ # Text outputs reflect selected SURVEYS, NOT selected map objects (although continuation points in # maps are pulled back to the survey, rather than reflecting any map objects that may be selected) # The outputs here are placed in their own folder. If the Output folder does not exist ERROR CP01 #!SURVEY LIST EXPORT export survey-list -output ../Output/Surveys.html #!CONTINUATION LIST EXPORT export continuation-list \ -attributes on \ -filter off \ -output ../Output/Continuations.html #!CAVE LIST EXPORT export cave-list \ -location on \ -surveys off \ -output ../Output/Caves.html \ #!DATABASE EXPORT export database -output ../Output/Database.sql ##Beyond here you should comment out exports you don't need. Some are very time consuming... #MAP/ATLAS 2D IMAGE OUTPUTS #======================= # 2D outputs reflect selected MAP objects NOT selected surveys # Statistics in maps reflect ONLY centreline objects that are partly or completely included in # scraps within the map object # xvi outputs reflect selected SURVEY objects however # Maintain multiple output variants (ie A3, A4 atlas etc) with # multiple 'input' layout files entered above, rather than making # edits below # If there is a unique top level map object 'title' (or otherwise survey 'title') # it is printed on the map output or atlas output ## Options for producing xvi's export map -projection [elevation 290 deg] \ -layout-scale 1 500 \ -layout-grid-size 1 1 1 metres \ -output ./Sketches/Elev290.xvi #for example ##Maps export map -projection plan \ -layout LayoutMapThisCave \ -layout LayoutMapThisCavePlan \ -output ../Output/Plan.pdf # -output ./Output/Plan.pdf export map -projection [elevation 290 deg] \ -layout LayoutMapThisCave \ -layout LayoutMapThisCaveElev290 \ -output ../Output/Elev290.pdf export map -projection [elevation 020 deg] \ -layout LayoutMapThisCave \ -layout LayoutMapThisCaveElev020 \ -output ../Output/Elev020.pdf #Can do above maps in .svg, but no transparency, fonts are a bit odd and no titles or legends ##Atlas export atlas -projection plan \ -layout LayoutAtlasThisCave \ -layout LayoutAtlasThisCavePlan \ -output ../Output/PlanAtlas.pdf export atlas -projection [elevation 020 deg] \ -layout LayoutAtlasThisCave \ -layout LayoutAtlasThisCaveElev020 \ -output ../Output/Elev020Atlas.pdf #!BOUNDING BOX EXPORT export map -output ../Output/-bbox.bbox #GIS MAP #======= # Only the outline shape file is of immediate use, the others are not symbolised export map -projection plan \ -output ../Output/GISPLAN/Plan.esri \ -format esri # required else pdf is produced with .esri extension!! A bug. #!3D MODEL OUTPUT #================ #3D model outputs reflect selected selected surveys NOT selected map objects #Includes wall outlines if wall-source is maps (the default I think). #Surface is very fast to export, but adds to file size, #Uses Loch (Therion viewer), comprehensive if a little clunky #Tip: create seperate models, one with surface only, one with caves only. #Resulting files are smaller, more versatile and can be imported into Loch allowing #simultaneous viewing export model -output ../Output/3DModel.lox \ -enable surface #No walls, no surface, fast to compile, small file size. #Requires Survex to view, slick, allows interogation of model export model -output ../Output/3DModel.3d #!3D GIS MODEL OUTPUT #==================== export model -output ../Output/GISMODEL/Model.esri \ -format esri #GOOGLE EARTH OUTPUTS #==================== # model line trace on ground surface (or hanging in space). Exports fast export model \ -output ../Output/3DModel.kml # shaded map on ground surface. Exports very slowly if wall-source is maps (the default I think) export map -projection plan \ -output ../Output/Plan.kml ###################################################################### # EXPORT SYNTAX GUIDANCE ONLY BELOW HERE # COMMON EXPORT OPTIONS #---------------------- # -output Can infer fmt from filemname.extension (except for esri) # # -enable/disable # -wall-source # SURVEY LIST EXPORT OPTIONS #---------------------- # Text Web Database # -fmt [text/html /dbf] # .txt/.html/.dbf # CONTINUATION LIST EXPORT OPTIONS #---------------------- # Text Web Database # -fmt [text/html /dbf] # .txt/.html/.dbf # -filter [(on)/off] ## if on, hides continuations without comments # -attributes [on/(off)] ## if off,hides user defined attributes # CAVE LIST EXPORT OPTIONS #---------------------- # Text Web Database # -fmt [text/html /dbf] # .txt/.html/.dbf # -location [on/(off)] ## includes or hides cave entrance coordinates # -surveys [on/(off)] ## if on, shows survey hierachy with aggregated statistics # DATABASE LIST EXPORT OPTIONS #---------------------- # Database # -fmt sql # .sql # 2D MAP EXPORT OPTIONS #---------------------- #Not all layout features are available in all formats # Adobe Web Survex CAD GIS Google Earth Therion bounding box # -fmt [pdf /svg /xhtml /survex/dxf /esri /kml /xvi /bbox] # .pdf/.svg/.xhtml/.3d /.dxf/.esri/.kml /.xvi /.bbox # -projection plan [elevation xxx deg] extended # -layout # -layout-xxx For example -layout-page-grid off # 'on' to show how atlas pages are cut, only for Map # 2D ATLAS EXPORT OPTIONS #---------------------- # Adobe # -fmt pdf # .pdf # -projection # -layout # 3D MODEL EXPORT OPTIONS #---------------------- # Loch Compass Survex CAD GIS Google Earth # -fmt [loch/compass/survex/dxf /esri /vrml /3dmf /kml ] # .lox/.plt /.3d /.dxf/.esri/.vrml/.3dmf/.kml #!END