| 1 | Installing Survex on Mac OS X |
|---|
| 2 | ============================= |
|---|
| 3 | |
|---|
| 4 | Next to the INSTALL file that you are currently reading is the Survex folder. |
|---|
| 5 | To install, just drag this folder to your Applications folder (you will need to |
|---|
| 6 | be logged in at an Administrator level to do this), or drag it to a folder |
|---|
| 7 | under your home folder. |
|---|
| 8 | |
|---|
| 9 | The programs alongside Aven.app need to be run from the command-line (open |
|---|
| 10 | Terminal.app): |
|---|
| 11 | |
|---|
| 12 | * extend produces extended elevations - this is probably the most useful of |
|---|
| 13 | these command line tools. |
|---|
| 14 | |
|---|
| 15 | * cad3d turns .3d files into various formats, but Aven's "Export" function |
|---|
| 16 | can do almost everything cad3d can, plus some extra formats. The main |
|---|
| 17 | benefit of cad3d is that it can be easily used in scripts. |
|---|
| 18 | |
|---|
| 19 | * cavern processes survey data, but since version 1.2.3 you can process .svx |
|---|
| 20 | files by simply opening them with Aven.app, so you no longer need to run |
|---|
| 21 | cavern from the command line. As with cad3d, the main reason to run cavern |
|---|
| 22 | directly is for use in scripts. |
|---|
| 23 | |
|---|
| 24 | * 3dtopos converts a .3d file to a .pos file. In Survex 1.2.19 and later, |
|---|
| 25 | aven can export .pos files, so the main benefit of 3dtopos is that it can |
|---|
| 26 | be easily used in scripts. |
|---|
| 27 | |
|---|
| 28 | * diffpos compares the positions of stations in two .3d, .pos, etc files. |
|---|
| 29 | |
|---|
| 30 | * sorterr sorts a .err file by a specified field. |
|---|
| 31 | |
|---|
| 32 | * dump3d dumps out a list of the items in a .3d file - it's mainly useful for |
|---|
| 33 | debugging. |
|---|
| 34 | |
|---|
| 35 | Known shortcomings specific to the Mac OS X version of Survex |
|---|
| 36 | ============================================================= |
|---|
| 37 | |
|---|
| 38 | These could be reproduced with Survex 1.2.19 when built using wxWidgets 3.0.2: |
|---|
| 39 | |
|---|
| 40 | * On OS X, usually you can push the mouse pointer against the top of the |
|---|
| 41 | screen to get the menu bar to appear, but this doesn't seem to work for |
|---|
| 42 | aven. As a workaround, aven detects if you're trying to do this and |
|---|
| 43 | drops out of full-screen mode, which isn't perfect but beats being stuck |
|---|
| 44 | in full screen mode. |
|---|
