Professional Documents
Culture Documents
Tutorial by Kyle Mills (ky.m.guy) Written September 2009 Requirements: GSAK Software (www.gsak.net) Groundspeak Premium Membership
This tutorial was written as a guide on how to setup GSAK to automatically generate and upload accurate statistics to your GSAK profile. It assumes that you GSAK installed and have a basic idea of the GSAK user interface and of using computers.If you have no clue how to use GSAK, you will probably find this tutorial very confusing and should probably read the help file here.
3) When prompted, select open 4) This will open GSAK with a message about installing, running or opening the macro (see below). Select Install and click Go.
5) 6) 7) 8)
Click Cancel on the next page that shows up. We dont need to use this yet. Repeat steps 2-5 with this link. (The AddLogs.gsk macro) Repeat steps 2-5 with this link. (The GenUploadStats.gsk macro) Repeat steps 2-5 with this link. (The Ontario_County_Tagger.gsk macro)
3) In a few minutes you will receive an email with a .zip file attached. Save this file to a location on your computer. 4) In GSAK, click File > Load GPX/LOC/ZIP 5) Setup the box that appears so that the yellow highlighted areas look like the image below. Press the red highlighted button and locate the downloaded .zip file.
6) Press OK GSAK will load the file into your found database.
6) Now click the check box under the current day for this pocket query (you will get an error message if you already have five check-marks under this day of the week)
7) This will generate the pocket query and email it to your email address. Now save the file and import it just like you did in Section B, Step C, Item 5 (except select the Placed database instead of Found). 8) Now you have a database with all of your placed caches in it. Note: Archived caches are not included in Pocket Queries. If you have placed caches that you have archived, you must go to the page and manually download and import the file into GSAK (into your Placed database) using the same settings as above (in item 7).
9) Press OK
7) A new window will appear: Select Placed as your first database to search. Leave the rest as-is. Click Search. (Note: you only have to perform this step on the very first macro run.)
8) Just press OK in the next window. The macro will now download all missing logs.
9) Press OK on the statistical message that appears. 10) Click on the next cache you want to add logs for and repeat items 3, 4, 5, 8 & 9 above. 11) You must run the macro on all placed caches that you own for your statistics to be correct.
6) The macro will now tag all waypoints in Ontario with the correct county name.
7) In order for the map to appear, you need to download this file to your macro folder inside of your GSAK installation folder. To find this folder, in the GSAK toolbar, click Tools>GSAK Folder Finder, select Macros and press OK.
Step C: FindStatGen.gsk
You are now ready to run the FindStatGen macro. 1) Click Macros (in the top toolbar) 2) Click Run/Manage 3) The macro manager window will appear. Double-click on the FindStatGen.gsk line. This will run that macro. 4) Select Options. 5) Set Basic Options: a. Select your Found database. b. Select your Placed database. c. Input a number in the milestone separation box. The macro will show every x number of caches that you have found. d. Input a number in the FTF separation box. The macro will show every x number of caches that you have got a first to find on. It will always include the most recent 10 FTFs e. Select your Home Location (see above for instructions on setting your home location) f. Select which colour you would like your statistics page to be. g. Select your language. h. Choose other options based on you preferences. i. Excluding Locationless caches will make it so that locationless caches are not considered when generating statistics. ii. Choose whether to show the difficulty/terrain chart. Selecting this will show this chart:
iii. Choose whether to show the cumulative finds chart. Selecting this will show this chart:
iv. Choose whether to use pie charts. If this is not selected, the statistics will display bargraphs in place of pie charts. v. If the Auto-run option is set, the macro will give you a ten second warning and then automatically generate statistics based on your last used settings. You can easily cancel the auto-run by clicking on the message that appears the next time you run the macro. For the purpose of this tutorial, please enable this option. vi. Centering the output will make the statistics center-justified instead of left-justified. i. Ensure that your username is correct in the Username field. Incorrect names will not affect the macros performance, it will just affect the appearance (The macro will use this username to personalise the statistics. ie: username has 10 finds on 10 unique geocaches.) j. Choose whether or not to use shaded bars. Using shaded bars will give the bar graphs a 3D look. k. Choose whether the statistics will be generated for use locally or remotely. If you are going to upload the statistics to the internet for others to view, choose remote. If you just want to view
the statistics on your computer only, select local. You can view remote statistics on your computer also as long as you have an internet connection available. l. I recommend saving your settings, press SAVE under the settings group box now to save. 6) Set Advanced Options: m. Notes: The notes section is a place for you to add any additional information about yourself like hobbies, a description about yourself, page counters, stat bars, etc. The notes section supports HTML but it is not necessary. i. Write a title in the section you wish to use. This title will be displayed at the top of the notes (No HTML in the title). n. Numbers: The numbers options allow you to choose which fields you will see under the Some Numbers option. i. You can choose any options that you want. This section does not affect this tutorial. o. Special: This section allows you to recognise those caches that are special to you. You cannot customize this option until the second time the macro is run. For instructions on how to use this advanced option, click here. p. Maps: You can download and use custom maps with the macro such as county maps and additional maps for countries other than US, Canada and Australia. Click here for a library of all additional maps that have been created. You must place the downloaded file in the GSAK Macros folder. For our use, please put a check beside the Ontario (full) option. q. Section Order: This controls the order in which the sections appear as well as which sections appear. i. Press the + or buttons to move the sections up and down. ii. Press to disable the section and to enable the section. iii. If you have written notes, make sure that the Notes A and/or Notes B is . iv. If you have selected custom maps (like the Ontario County map that I created) make sure that the Other Maps section is . r. Now save your settings again by pressing save as you did in step 2. 7) Press OK to generate statistics. 8) Just close the statistics that the macro generates for now
Step D: GenUploadStats.gsk
**CAUTION** This macro will erase the information that you previously have in the Geocaching.com profile page. If you have information in this profile area which you would like to preserve, copy it to the Notes section of the FindStatsGen macro. 1) Click Macros (in the top toolbar) 2) Click Run/Manage 3) The macro manager window will appear. Double-click on the GenUploadStats.gsk line. This will run that macro. 4) Input the information required (Username and Password). This is required so that the macro can log into your profile and change your statistics. 5) If you saved your settings in the FindStatGen macro, select the number that you saved them as. If you are unsure, just select 1. Chances are it will work.
6) The macro will now call up the FindStatGen macro that you have installed and configured and will upload them to your profile page.
Have fun!