debian/0000755000000000000000000000000011731667641007202 5ustar debian/changelog0000644000000000000000000000201611731667637011060 0ustar terraintool (1.12a-1) unstable; urgency=low * New upstream release -- Wookey Mon, 19 Mar 2012 12:06:50 +0000 terraintool (1.09a-3) unstable; urgency=low * Don't explicitly define JAVA_HOME in rules (Closes:#640583) Thanks to Mònica Ramírez * Rebuilt using fixed libarchive-zip-perl (Closes:#649842) -- Wookey Mon, 05 Dec 2011 13:42:30 +0000 terraintool (1.09a-2) unstable; urgency=low * Correct section and priorty to science,extra -- Wookey Tue, 23 Aug 2011 11:55:42 +0100 terraintool (1.09a-1) unstable; urgency=low * New upstream release * Use jar and drop jastjar dep -- Wookey Mon, 22 Aug 2011 11:34:13 +0100 terraintool (1.09-1) unstable; urgency=low * New upstream release * Add missing docbook-to-man build-dep -- Wookey Mon, 22 Aug 2011 01:05:48 +0100 terraintool (1.08-1) unstable; urgency=low * Initial release. -- Wookey Fri, 19 Aug 2011 17:25:08 +0100 debian/terraintool.desktop0000644000000000000000000000037111731620531013123 0ustar [Desktop Entry] Version=1.0 Name=Terraintool surface mesh generator GenericName=Cave Terrain generator/converter Comment=Generate surface mesh in survex format Type=Application Exec=terraintool Icon=terraintool Categories=Education;Geology;Science; debian/terraintool.menu0000644000000000000000000000020211731620531012407 0ustar ?package(terraintool):needs="X11" section="Applications/Science/Geoscience"\ title="terraintool" command="/usr/bin/terraintool" debian/terraintool.javadoc0000644000000000000000000000001111731620531013050 0ustar internal debian/manpage.sgml0000644000000000000000000005110411731643241011465 0ustar Wookey"> March 19, 2012"> 1"> Wookey <wookey@debian.org>"> Terraintool"> Debian"> GNU"> GPL"> ]>
&dhemail;
&dhsurname; 2009-2012 &dhusername; &dhdate; &dhucpackage; &dhsection; &dhpackage; Generating surface meshes for cave survey software &dhpackage; DESCRIPTION TerrainTool is used to create surface topographic data for the cave survey packages Survex and Therion. This uses the results of the Shuttle Radar Topography Mission (SRTM) in which the shuttle Endeavour mapped the height of the Earth's surface between the latitudes 60 degrees North and 56 degrees South - about 80% of the Earth's land mass. Resolution was 1 arc-second for the US and its territories and 3 arc-seconds elsewhere. The latter corresponds to about 90m at the equator. The resulting data is royalty-free and, for many countries, may be the only data publicly available. More recently, the Advanced Spaceborne Thermal Emission and Reflection Radiometer (ASTER) project has published data at 1 arc-second resolution for the land masses between 83 degrees North and 83 degrees South and is also royalty-free. Whilst the SRTM data contains numerous "voids" caused by shadowing in steep or mountainous areas, the ASTER data was built from stereo images taken over a much longer period of time and as a result is much more complete. It does, however, suffer from "artefacts" - spurious features which are by-products of the imaging process. SRTM data is available to all on the Internet from a NASA server and TerrainTool automatically fetches anything it needs. The mechanism for accessing ASTER data is slightly more complicated in that users need to register first on the US or Japanese website and then "order" (at no cost) the files that they need. A few minutes later, the system sends the user an e-mail containing a link to a zip file containing the relevant files. This can be downloaded via FTP or using a standard web browser. A zip file containing the tiles for the UK and Ireland, for example, was a little over 500MB. Unfortunately, it's not possible for a tool like TerrainTool to take care of the downloading of ASTER data automatically. More instructions on how to do this manually can be found below. TerrainTool does the following:- Automatically downloads SRTM data from the NASA ftp site as needed. Converts between spherical (Lat/Lon) coordinates and a variety of map coordinates. Coordinate systems currently supported include British (OSGB) grid, Irish grid, UTM, French (Lambert conical projections) and Austrian. Additional mapping systems can be added quite easily. Re-samples the data using bilinear interpolation to create a rectangular mesh of user-specified spacing. Displays a coloured topographic map of the mesh. Adds a user-specified offset (3-D) to the coordinates to align with coordinates used for the underground survey. Saves the mesh as surface data in Survex (.svx) or Therion (.th) format. The programme, written in Java, provides a conventional GUI-style interface and will run under Windows, Solaris and Linux operating systems. The latest Java Runtime (JRE 6 or JDK 6) is required and can be downloaded free of charge from Oracle. "TerrainTool" was written by Mike McCombe who is very grateful to UBSS for giving it a home. Please feel free to contact Mike with feedback or requests for help at mikemccombe <at> btinternet.com or via the Survex list. Driving Instructions TerrainTool is a conventional GUI-based application with a menu bar and dialog boxes to gather user-information. To get started, do the following: Select the required region and coordinate system using the Options menu Go to Create on the File menu to specify the size, location and resolution of the mesh. Save the results as in Survex (.svx) or Therion (.th) format Use Survex to process the file and Aven to view the results in 3D. Remember to enable viewing of surface legs in Aven! Use the Offset command in the Options menu to fully align the terrain data with the coordinates used in your survey. When generating surface data in Therion format, Therion needs to be told the coordinate system used for the surface data in a form that it recognises (e.g. EPSG:27700). See the description of the surface command in the Therion Book for more details. Incorporate the terrain data into your survey project. File Menu Create... is used to calculate the terrain mesh. A dialog box is used to gather the following:- Create dialog items Item Meaning Grid Reference The grid reference for the mesh, expressed in the current coordinate type. This point can be at the centre of the mesh, any of the corners or the mid-point of ant of the sides (see below). An example in the correct format is shown below the text field. E-W Range The distance (in metres) between the East and West edges of the mesh. N-S Range The distance (in metres) between the North and South edges of the mesh. Spacing The distance (in metres) between adjacent cells in the mesh. Grid ref is at Specifies where current point (see "Grid Reference" above) lies in relation to the boundaries of the mesh. Pressing OK starts the calculation of the mesh points. If "Auto-download" is enabled, data files will be downloaded as needed from the Nasa ftp site. These are stored in the "data" subdirectory for later re-use if necessary, avoiding the need to download the same file again. At the end of the calculation, results are displayed as a simple coloured relief map. The mouse position is displayed (in current coordinates) in the message bar on the bottom edge of the frame. Lat/Long... provides a means of defining the current point in terms of latitude and longitude, rather than as a grid reference. If the point can be represented as a valid grid reference in the current coordinate system, it is used to initialise the "Grid Reference" field of the "Create..." dialog box. Likewise, the current grid reference is used to initialise the Lat and Long fields with the latitude and longitude of the current point. Latitude and longitude values can be expressed as either real values in degrees (e.g. 46.25), where negative values are West / South, or values in degrees, minutes and seconds (e.g. 46 N 15' 22.6") Latitude and Longitude are usually based on the WGS-84/GRS-80 datum and ellipsoid. The user may select alternatives, which will cause the lat and long values to be re-calculated. Save as... Once a mesh has been calculated, the "Save as..." command can be used to save the terrain data. Normally, this will be in Survex (.svx) or Therion (.th) format. Occasionally, there may be missing values (known as "voids") in the SRTM data - particularly in mountainous areas where steep faces may have been hidden from the Shuttle's line of sight. Generally, TerrainTool will "repair" individual voids by interpolating from the surrounding cells. However, if this isn't possible, gaps are left in the mesh where no data is available. Otherwise, height values are defined for each point in the mesh. Easting and Northing values are those of the current coordinate system. Options Menu Coordinates... This is used to select the type of coordinates to use. The following are currently supported: Coordinate Systems Coordinate System Description Austrian The Austrian (BMN) coordinate system, in three zones Irish Grid The Irish grid system, used in both Northern Ireland and the Republic of Ireland. Lambert 93 The Lambert 93 coordinate system. A conformal conical projection occasionally used in France. Lambert (5 zones) The coordinate system most commonly used in France. Three zones (I, II and III) cover North, Central and Southern France. Zone IV is used in Corsica. A fifth zone (II-extended) covers the whole of France, at the expense of greater distortion. NZMG New Zealand Map Grid - New Zealand's coordinate system superseded in 2010. Maps based on this are no longer available, but still widely used. Based on a conformal orthomorphic projection. NZTM2000 New Zealand Transverse Mercator, successor to NZMG. OSGB Ordnance Survey of Great Britain - the normal British grid system. UTM Universal Transverse Mercator, devised by the US Department of Defense to cover the globe (except polar regions) in 60 zones. Also used by many national mapping agencies, often with a national or regional datum instead of WGS84.
One of the design objectives of this software is to be able to add further coordinate systems with minimal difficulty. Selecting a coordinate system from the drop-down list results in automatic selection of sensible defaults for the datum and ellipsoid. The user is free to override this selection using the other two drop-down lists. Whilst, for example, OSGB invariably uses its own datum and the "Airy Sphere", other systems are frequently used with a variety of datums. UTM, for example, is used in Spain with the European (1950) Datum and Australia with their own (MGI) datum. Auto download enables/disables the automatic downloading of data from the NASA SRTM site. Region The SRTM data site is organised into six regions - Africa, Australia, Eurasia, North_America, South_America and Islands (New Zealand and islands of the Pacific). As I don't have a simple method of determining the region automatically from lat/lon, you will need to manually select the right region. Offset This provides a simple way of adding a fixed 3-D offset to mesh point in the mesh as it is saved. You might want to do this because Your cave survey coordinates might not use the full easting and northing values The height values differ from "known" surface heights in your survey. SRTM heights are referenced to EGM96 (Earth Geopotential Model 1996) and may be significantly offset from a national height datum. SRTM Only Creates terrain using only SRTM data. Any "voids" which cannot be filled by interpolation will result in gaps in the output data. If auto-download is selected and there is an Internet connction, missing tiles will be automatically downloaded from the NASA server. ASTER Only Creates terrain using only ASTER data. This has higher resolution and greater coverage than SRTM data but must be manually downloaded and installed (see below). Its greater resolution causes TerrainTool to run more slowly than with SRTM data. The end-result may show signs of "artefacts" - spurious features produced by the imaging process. SRTM plus ASTER Uses ASTER to fill any "voids" in the SRTM data. This option minimises the processing time and "artefact" penalties of using ASTER data whilst leaving the least number of voids in the finished product. Legacy ASTER Data By default, version 1.11 onwards of TerrainTool assumes ASTER data to be from the ASTER 2 dataset. This contains fewer artefacts than the original ASTER dataset. However, if you need to use the original data files, select this option. Installing ASTER data files Obtaining ASTER data is free and quite straightforward. The first step is that you will need to register and, when you've logged in you can use the tool on the WIST web site to select the "granules" you need - most easily by just dragging an area on a map of the world. Having ticked various boxes to confirm agreement to their terms and conditions, the selection is bundled up into an "order". A few minutes later, the system sends an e-mail to the address you gave at registration and this contains a link to a zip file containing the tiles you selected and instructions on how to download it using either a browser or a command-line ftp client. Each "granule" contains the data for a 1-degree by 1-degree tile of the earth's surface and is in two files - an xml descriptor (e.g. ASTGTM_N50E002.zip.xml) and a zip file (e.g. ASTGTM_N50E002.zip) containing the data itself. The first time you run TerrainTool it will create a sub-directory called "data" (in the directory containing TerrainTool.jar). This is used to store both SRTM tiles and ASTER granules. Use a standard "zip" utility (e.g. WinZip) to extract the data files (e.g. ASTGTM_N50E002.zip) and place them in this directory. Do NOT unpack the zip files themselves - TerrainTool decompresses the contents as it reads them. A similar procedure can be used to install SRTM data files manually. Simply copy data tiles (e.g. N51W003.hgt.zip) into the "data" sub-directory. AUTHOR This manpage was generated from the online documentation at http://www.ubss.org.uk/terraintool/terraintool.php, which is also reproduced in file:///usr/share/doc/terraintool/README.html. Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 3 published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. debian/source/0000755000000000000000000000000011730107044010463 5ustar debian/source/format0000644000000000000000000000001311730107042011666 0ustar 3.0 (quilt)debian/javabuild0000644000000000000000000000002411731620531011045 0ustar terraintool.jar src debian/compat0000644000000000000000000000000211731620531010363 0ustar 7 debian/terraintool.install0000644000000000000000000000026711731663107013132 0ustar terraintool.jar usr/share/terraintool debian/terraintool.desktop /usr/share/applications doc/README.html /usr/share/doc/terraintool/ doc/ReleaseNotes.html /usr/share/doc/terraintool/ debian/copyright0000644000000000000000000000356011731636025011131 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: Terraintool Upstream-Contact: Mike McCombe Source: http://www.ubss.org.uk/terraintool/terraintool.php Files: * Copyright: 2008-2012 Mike McCombe License: GPL-3 This program is free software; you can redistribute it and/or modify it under the terms of version 3 of the GNU General Public License as published by the Free Software Foundation. . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA . On Debian systems, the full text of the GNU General Public License version 3 can be found in the file /usr/share/common-licenses/GPL-3'. Files: debian/* Copyright: 2010-2012 Wookey License: GPL-3 This program is free software; you can redistribute it and/or modify it under the terms of version 3 of the GNU General Public License as published by the Free Software Foundation. . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this package; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA . On Debian systems, the full text of the GNU General Public License version 3 can be found in the file /usr/share/common-licenses/GPL-3'. debian/manpages0000644000000000000000000000001611731620531010700 0ustar terraintool.1 debian/rules0000755000000000000000000000061111731620531010243 0ustar #!/usr/bin/make -f # DH_VERBOSE=1 # Put depended upon jars in here # export CLASSPATH= %: dh --with javahelper $@ override_dh_clean: dh_clean rm -f terraintool.1 override_dh_installman: docbook-to-man debian/manpage.sgml > terraintool.1 dh_installman override_dh_install: dh_install jar uMf debian/terraintool/usr/share/terraintool/terraintool.jar -C src mccombe/terrain/images debian/terraintool.doc-base.readme0000644000000000000000000000032211731620531014357 0ustar Document: terraintool Title: Terraintool documentation Author: Mike McCombe Section: Science/Geoscience Format: HTML Index: /usr/share/doc/terraintool/README.html Files: /usr/share/doc/terraintool/README.html debian/terraintool.manifest0000644000000000000000000000017611731620531013263 0ustar usr/share/terraintool/terraintool.jar: Main-Class: mccombe.terrain.TerrainFrame Debian-Java-Home: /usr/lib/jvm/default-java debian/patches/0000755000000000000000000000000011731666306010626 5ustar debian/patches/use-XDG-paths.diff0000644000000000000000000000223411731626221014002 0ustar Description: Use XDG spec paths for internal files Use the supplied implementation of unix XDG paths for internal files instead of the default .terraintool location Also fix up missing separator bug in implementation . terraintool (1.12-1) UNRELEASED; urgency=low . * New upstream release Author: Wookey --- Forwarded: yes Last-Update: <2012-03-14> Index: terraintool-1.12a/src/mccombe/terrain/TerrainFrame.java =================================================================== --- terraintool-1.12a.orig/src/mccombe/terrain/TerrainFrame.java 2012-03-19 12:53:24.407149543 +0000 +++ terraintool-1.12a/src/mccombe/terrain/TerrainFrame.java 2012-03-19 12:54:35.635502735 +0000 @@ -1729,7 +1729,7 @@ * Pathnames object to point to properties file and data cache * */ - protected static Pathnames paths = new DefaultPathnames(); //Change this class to achieve os-specific behaviour + protected static Pathnames paths = new UnixPathnames(); //Change this class to achieve os-specific behaviour private final Timer messageTimer; private final Timer busyIconTimer; private Icon idleIcon = null; debian/patches/READMEcharsetfix.diff0000644000000000000000000000661411731666306014505 0ustar Description: Put a charset indicator into README Always say what charset something is. Also fix up big whitespace dollop . terraintool (1.12a-1) unstable; urgency=low . * New upstream release Author: Wookey --- Last-Update: <2012-03-19> Index: terraintool-1.12a/doc/README.html =================================================================== --- terraintool-1.12a.orig/doc/README.html 2012-03-19 17:04:55.000000000 +0000 +++ terraintool-1.12a/doc/README.html 2012-03-19 17:28:30.152997119 +0000 @@ -1,6 +1,6 @@ - + TerrainTool - create surface topographic data for Survex and Therion @@ -48,7 +48,6 @@
  • Displays a coloured topographic map of the mesh. -
  • Adds a user-specified offset (3-D) to the coordinates to align with coordinates used for the underground survey. @@ -60,8 +59,7 @@

    The programme, written in Java, provides a conventional GUI-style interface and will run under Windows, Solaris and Linux operating systems. The latest Java - Runtime (JRE 6, JDK 6 or later) is required and can be downloaded free of charge from Oracle, for example. + Runtime (JRE 6, JDK 6 or later) is required and can be downloaded free of charge from Oracle, for example.

    "TerrainTool" was written by Mike McCombe who is very grateful to UBSS for giving it a home. Please feel free to contact Mike with feedback or requests for help at @@ -370,8 +368,7 @@ ASTER Only

    - Creates terrain using only ASTER data. This has higher resolution and greater coverage than SRTM data but must be manually downloaded and installed (see below). Its greater resolution causes TerrainTool to run more slowly than with SRTM data. The end-result may show signs of "artefacts" - spurious + Creates terrain using only ASTER data. This has higher resolution and greater coverage than SRTM data but must be manually downloaded and installed (see below). Its greater resolution causes TerrainTool to run more slowly than with SRTM data. The end-result may show signs of "artefacts" - spurious features produced by the imaging process.

    debian/patches/series0000644000000000000000000000010311731663323012031 0ustar use-XDG-paths.diff READMEcharsetfix.diff ReleaseNotes-rename.patch debian/patches/ReleaseNotes-rename.patch0000644000000000000000000001051011731663417015502 0ustar Description: Fix typo in ReleaseNotes filename RealeasNotes.html -> ReleaseNotes.html . terraintool (1.12a-1) UNRELEASED; urgency=low . * New upstream release Author: Wookey --- Last-Update: <2012-03-19> --- /dev/null +++ terraintool-1.12a/doc/ReleaseNotes.html @@ -0,0 +1,60 @@ + + + + + TerrainTool Release Notes + + + + +

    Version 1.12a

    +

    ASTER 2

    +

    This version bring support for the ASTER-2 dataset that has recently become available. This + has the same resolution as the original ASTER data but the processing has resulted in fewer artefacts. Internally, + the data format is the same as before but the filename e.g. ASTGTM2_N51W003.zip now includes a "2" to indicate that it + is from the ASTER-2 dataset. Note: you can't just read the file and read it as though it came from the original + ASTER dataset because the files inside the outer zip "wrapper" also have a "2" added to their names.

    +

    File Locations

    +

    Previous versions of TerrainTool running under Windows placed the terraintool.properties and data directory + in the same directory as terraintool.jar. Under unix-family operating systems, (e.g. Ubuntu, Debian) these + files were created in the current working directory, wherever that happened to be. If the current directory + already contained a sub-directory called "data", terrain data files were just added to it. This sometimes resulted + in terrain data being added to unrelated data directories and, potentially, duplication of data.

    +

    + The sections below explain where the data files and properties file will be located, according to whether you + have the cross-platform version (default) or used an application installer under Ubuntu or Debian. If you already have + data that has been downloaded from the SRTM or ASTER sites, you may want to copy these into the new data directory to + avoid having to download them again. +

    +

    Cross-platform version

    +

    + If you downloaded TerrainTool as a "jar" file from the UBSS web site, you have the cross-platform version which is + built to run under Windows, Unix family (Ubuntu, Debian, Solaris etc.) and OS X. + By default, this version of TerrainTool creates the terraintool.properties and the data store in the + .terraintool sub-directory of the user's home directory. For recent Windows versions, this would be something + like c:\users\Mike\.terraintool or /home/mike/.terraintool on Ubuntu. Note that normally, Unix-family operating + systems treat directories starting with "." as hidden - hence the sub-directory may not be visible. +

    Unix-specific Version

    +

    + Apart from downloading terraintool.jar from the UBSS web site, TerrainTool can also be installed as a + pre-packaged application for Ubuntu and Debian (thanks to Wookey!). This is identical to the cross-platform + version, except that the properties file and data directory are placed in a more unix-friendly location, as follows:- +

    +
      +
    • If $XDG_CONFIG_HOME is set, terraintool.properties goes in $XDG_CONFIG_HOME/terraintool/. Otherwise, it goes + in $HOME/.config/terraintool/ +
      • +
    • + if $XDG_DATA_HOME is set, the data directory is $XDG_DATA_HOME/terraintool/ Otherwise it is $HOME/.local/share/terraintool/ +
      • +
    +

    Customisation

    +

    + If building TerrainTool from source-code, the file locations are easily customised by changing a single + line of TerrainFrame.java and writing a class to implement the Pathnames interface. See Pathnames.java. +

    + + debian/control0000644000000000000000000000145211731620531010572 0ustar Source: terraintool Section: science Priority: extra Maintainer: Wookey Build-Depends-Indep: debhelper (>= 7.0.50~), javahelper (>= 0.32), default-jdk, docbook-to-man Standards-Version: 3.9.3 Homepage: http://www.ubss.org.uk/terraintool/terraintool.php Package: terraintool Architecture: all Depends: ${java:Depends}, ${misc:Depends} Description: Generates survex format terrain models from SRTM and ASTER data This tool generates terrain meshes for cave survey tools from online datasets. It uses the NASA SRTM and European ASTER datasets. The relevant data is downloaded and excepted, geolocated to the desired co-ordinate system, resampled to a mesh grid, an offset to local grid added if required, the result displayed, and saved in survex (.svx) format. It is written in java. debian/terrain.properties0000644000000000000000000000042111731620531012744 0ustar http://dds.cr.usgs.gov/srtm/version2_1/SRTM3/ srtm debian/terraintool.links0000644000000000000000000000007211731620531012570 0ustar usr/share/terraintool/terraintool.jar usr/bin/terraintool