Home » File Formats » File_Therion

File_Therion provides an object oriented interface to Therions .th cave-data files.

Download latest release 0.4.1 (archived versions might be outdated)

License: LGPLv3

Description

File_Therion provides object oriented interface for parsing, handling and writing Therion (http://therion.speleo.sk/) cave survey data files (*.th).
It features Therions data model as PHP objects and can be used to interface between therion data files, various databases and PHP based user applications.

Maintainers

• Benedikt Hallinger (beni) — lead, active

Dependencies

Required

• PHP (>= 5.4.0)
• PEAR Installer (>= 1.6.1)

Releases

• 0.4.1 (alpha, 2018-01-20)
  Release notes

  License: LGPLv3

  * Missing grade file in sources

• 0.4.0 (alpha, 2017-03-10)
  Release notes

  License: LGPLv3

  * Bugfix in centreline parsing of declination command.
  * Added better distinction for LRUD data for "missing data" ("-" according to survex) and really unset data.

• 0.3.1 (alpha, 2016-12-14)
  Release notes

  License: LGPLv3

  Bug fix release for 0.3.1:
  Reimplemented Line::getDatafields() with a (hopefully) more robust
  version, thereby fixing a corner case and a bug with slash in station
  names.

• 0.3.0 (alpha, 2016-12-13)
  Release notes

  License: LGPLv3

  Please note, that this release introduces some API changes that may be incompatible with your code.
  * Implemented File_Therion::updateLines(); its now possible to create data files out of the object model!
  * Fixed many small bugs
  * Enhanced syntax checking
  * Enhanced phpunit test cases
  * Enhanced StructuredWriter to be able to deal with more file generation variants
  * Added get*Dimension() functions in accordance with set*Dimensions(); old functions removed!
  * Better handling for anonymous stations; they always report dash/dot as name regardless of prefix/postfix setting
  * Fixed bug with generated equate commands, the survey chain was wrong with nested surveys
  * Added header functionality, now one can specify a global header to be printed to any file
  * Added basic centreline declination handling
  * Added cs (coordinate-system) export support
  * Better handling for default unit printing of units
  * Fixed a bug with some locale's reporting comma instead of dot on float values (like length)
  * Added support for grade-definitions
  * Centerline: Implemented ordering of date/explo-date, team/explo-team commands.
  * Centerline: RENAMED setDate() and setExploDate() to addDate() and addExploDate().
  * Added Formatter-Feature: this allows you to add arbitary formatting instructions.
  Two default formatters exist by now:
  - File_Therion_BasicFormatter has basic formatting features and may serve as extension platform.
  - File_Therion_AddLineNumberFormatter as a small demo formatter, usable also for debug purposes.

• 0.2.1 (alpha, 2016-07-02)
• 0.2.0 (alpha, 2016-06-16)
  Release notes

  License: LGPLv3

  This release features some major enhancements and bugfixes compared to
  0.1.0. Basic examples parse well, data part is usable in many aspects.
  The rabbit example is nearly fully supported, one major missing feature
  is lacking surface support.

  Please refer to the APIdocs TODO list for details on what is missing.

  * Added better equate handling (now at stations, deep equates supported)
  * Parsing of data files now correctly reuses parsed station objects
  * Better handling for string references (eg. foo@barsurvey)
  * Adjusted Station->getName() to report full name by default
  * Added loop detection to survey structure
  * Added a function to get all (recursive) surveyed stations of survey
  * Added a StructuredWriter to write survey into several files
  * Parsing input commands: support for absolute file paths
  * ... and various smaller enhancements and bug fixes

• 0.1.0 (alpha, 2016-04-23)
  Release notes

  License: LGPLv3

  Initial release of first API. Still in development!
  Therion data model core features should be mostly supported already;
  that means survey structure and centreline data should be usable mostly.
  The package is still not stable and API may change in future versions.

  Please refer to the TODO tags in the API to get an idea what is still missing.
  You can expect basic survey structure, important metadata and centreline to be working.
  Scraps, Maps, surface and many data fields are still unsupported however should parse OK silently.

  This release is dedicated to my friend Dr. Stefan Dahm, who died in the
  Hirlatz cave (Dachstein, Austria) on 28.02.2016 while conducting an
  expedition. We miss you Stefan! Your work will be continued...

Bugs

No bugs.