Author Topic: 3d file format  (Read 1352 times)

Offline Cave Mapper

  • obsessive maniac
  • ***
  • Posts: 346
    • CaveMaps.org
3d file format
« on: May 20, 2011, 11:15:04 pm »
Where can I find a description of the 3d file format?
CaveMaps.org - putting caves on the map

Offline The Old Ruminator

  • forum hero
  • *****
  • Posts: 3098
Re: 3d file format
« Reply #1 on: May 21, 2011, 08:47:39 am »
Now I havn't a clue what I am talking about but just in case would this help.?

Wikipedia.

Survex is an open source cave surveying software package, licensed under the GPL. It is designed to be portable and can be run on a variety of platforms, including Microsoft Windows, Mac OS X, and Unix. Survex is very powerful cave survey software, and is actively developing into a complete cave visualization package.

Centreline data is entered using plain text files, which are processed by 'Cavern'. The text files contain a hierarchy of cave surveys, each of which consists of a list of survey legs, which join survey stations. This program calculates the real world coordinates of survey stations, taking into account loop closure errors using least-squares minimization.[1] This processed data can then be visualised using a GUI front end called Aven. Survex has no arbitrary limits, and so is particularly good for large complicated cave systems, or areas where you need to see the relationships between multiple cave systems.

Survex was started in 1990 by Olly Betts and Wookey, and more recently Mark Shinwell has developed 'Aven'. Like most cave surveying software, the motivation for its creation arose from a particular surveying project - Cambridge University Caving Club's explorations in Austria.[2]

Survex is currently being used in many large scale survey projects, across the world, for example: UK - Easegill,[3] Ogof Draenen,[4] Spain - Picos de Europa,[5] China,[6] Austria - Dachstein, Totes Gerbirge,[7] Indonesia,[8] Mulu[9]

Offline jarvist

  • obsessive maniac
  • ***
  • Posts: 424
  • Imperial College CC / Northern Pennine Club
    • Imperial College Caving Club
Re: 3d file format
« Reply #2 on: May 21, 2011, 01:32:32 pm »
I'm not sure if it is described anywhere. When I did something with it I think I just used the survex source img.c and 3dtopos -- have a look at function img_read_item in img.c (around line 840).

I think I actually remember somewhere in the comments / description it said it used cm as a unit, but it turned out to actually use m as the unit?


Offline Cave Mapper

  • obsessive maniac
  • ***
  • Posts: 346
    • CaveMaps.org
Re: 3d file format
« Reply #3 on: May 21, 2011, 09:51:40 pm »
Found it.

I was searching the web for it and it turns out I already had it on my PC. It's in the documentation that gets installed with Survex.

It only describes version 5 though and the first file I opened was version 6, so it might not be up-to-date. I guess, as Jarvist suggests, the definitive documentation is the source code.
CaveMaps.org - putting caves on the map

Offline jarvist

  • obsessive maniac
  • ***
  • Posts: 424
  • Imperial College CC / Northern Pennine Club
    • Imperial College Caving Club
Re: 3d file format
« Reply #4 on: May 22, 2011, 01:09:02 am »
Ah hah, 3dformat.htm !

The one in the Survex 1.1.16 distribution (survex-1.1.16/doc/3dformat.htm) apparently contains info on up to V.7 (from the file, last updated: 2010-08-18).