diff --git a/handbook/troggle/old_make_essentials.html b/handbook/troggle/old_make_essentials.html new file mode 100644 index 000000000..fac28849c --- /dev/null +++ b/handbook/troggle/old_make_essentials.html @@ -0,0 +1,66 @@ +Old make_essentials script + + +

CUCC Expedition Handbook

+

Old make_essentials script

+ +

This is now replaced by the much simpler 2025 process which does not go back and forth between survex format and GPX format. +

This text is not deleted because we a re not sure whether some of it may yet be useful (July 2025). +

+

This is all obsolete

+

In :loser:/gpx/ This: regenerates the surface tracks as survex files from GPS .gpx files. Also requires the gpx2survex program. +

We used to use the OCAML program gpx2survex but we now also have a python equivalent gpx2survex.py which is used by make_svx2.sh This is part of the make_essentials generation process. +

gpx2survex simplifies a track so that it is less voluminous. +

For the reverse process we don't need a script. For svx-to-gps we can use survexport: Olly says [2022]: "you shouldn't need to mess around with undocumented scripts - since 2018, you can just do: + survexport --entrances all.3d essentials.gpx" +

But that does rather rely on all.3d being properly generated, which troggle does not currently do reliably and automatically. +

Documented, by man survexport, survexport --help, + and in the Survex manual on survexport. + + +

ogr2ogr

+ If you need to refresh everything from scratch, e.g. if the kataster boundary data shapefile is updated (unlikley), then download GDAL which contains the ogr2ogr2 executable and can convert to gps: + format gpx. The command line to do this is:
+ogr2ogr -f GPX -nlt MULTILINESTRING -t_srs EPSG:4326 -s_srs EPSG:32633 boundaries.gpx 4_Teilgruppen_UTM_33_N_2021_01.shp -dsco GPX_USE_EXTENSIONS=YES + + +

convert_shx.ml

+

Obsolete. We do not need this as we use ogr2ogr on the command line to generate the boundaries as a GPX file from the shapefile (.shp) format. This only needs to be done once. +

+

Unusually, this is in the :loser: repository, in :loser:/fixedpoints/scripts/convert_shx/ +

We think this turns a shapefile which holds the coordinates of the 1623, 1624 boundaries into GPX. But we have mislaid the shapefile containing this vital data. We now have the shapefile again. +

It runs ogr2ogr -f csv -lco GEOMETRY=AS_WKT outputfile inputfile and then extensively post-processes the shapefile output. +It is written in OCAML. Therefore it must be Mark Shinwell's responsibility. +

ogr2ogr is a file conversion utility. +It seems to be being run to convert CSV files into something else. The "shx" part of the name implies a +shapefile index format. +

We suspect this was part of the production process for originally making essentials.gpx, but we don't need it as we now have the boundary data in other formats. +

+
+
+ + +

Click for enlarged view +
+
+
+

This needs re-writing because the process is highly confusing: see the "documentation" in the diagram on the right. ALSO the 2024 process created a GPX track which was unusable in OSMand (our preferred GPS app) because it put every point into a separate trkseg. +

In :loser:/gpx/ [2024 text] +

Makes essentials.gpx - see GPS on expo. +This used to require the gpx2survex program (written in OCAML) but now doesn't (since 2023). +Get the OCAML file from GitHub https://github.com/mshinwell/gps2survex; +

Read the README file in :loser:/gpx/y. +

Someone needs to document this and and make_svx.sh properly. +