This is a git repository for ShakeAlert EEW geodetic metadata.

Basic Channel Files
-------------------
Each time data producers' channel files chanfile_{bk,ci,nc,pb}.dat change do the following:
  1. Check if all new stations in channel file(s) are in 'station_coords.dat':
     This is done automaticaly via chron script $HOME/bin/update_metadata.sh

  2. 'add' and 'commit' changes to local GIT repository:
     $ git status
     $ git add <file(s)>
     $ git commit -m <comment> 

  3. Push changes to master repository
     $ git push origin master

  4. Copy changed metadata files to the public HTTPS directory which currently is one level
     above this dir:
     $ cp -p <file(s)> ..

  5. For now do not publish "station_coords_extended.dat"; its strictly for internal geodesist
     use.


Station Acceptance and Merged Channel File
------------------------------------------
The merged channel file used by GFAST-PGD is named "merged_chanfile_coord.dat". This file is
generated daily via cron at 11:15AM Pacific Time. The latest generated version and can be found
under "https://ncedc.org/outgoing/gps/ShakeAlert/metadata/STAGE/STN_ACC/", or within tBSL under
./STN_ACC/.

About every 30 days, at the time of EEW "repo freeze" and before the EEW server patch cycle begins,
this file is manually sanity checked, checked into ShakeAlert GITlab, and copied to the directory
above this directory. This way when the servers are patched GFAST is restarted so all EEW servers
will be using the same channel file for GFAST.
  

Notes on USGS GITlab
--------------------
- Need to set up a Personal Access Token (PAT) on the USGS GitLab website after loggin in with 2FA:
  https://code.usgs.gov/-/profile/personal_access_tokens
  Currently this token name is 'ShakeAlert'; set it to expire in 12 months (max allowed).
  Copy the token value which is only available once at the time the new 'Token name' is created.

- Edit the `upstream' configuration in the local repository's `.git/config':
  url = https://<PAT_name>:<PAT_value>@code.usgs.gov/eew/geodetic-metadata.git
  Example:
  url = https://ShakeAlert:glpat-XXXX@code.usgs.gov/eew/geodetic-metadata.git
  Note: This could be insecure especially since the STAGE dir is in a public directory so set
  permissions on /work/outgoing/gps/ShakeAlert/metadata/STAGE/.git to 700

- Alternatively if the remote repo exists, clone the remote repo locally using the above URL:
  git clone https://<PAT_name>:<PAT_value>@code.usgs.gov/eew/geodetic-metadata.git
  Example:
  git clone https://ShakeAlert:glpat-XXXX@code.usgs.gov/eew/geodetic-metadata.git

- To update local checkout:
  $ git pull

- After local edits and testing push local repository to gitlab using:
  $ git push orign master

- Other useful commands:
  $ git push --set-upstream origin --all
  $ git push --set-upstream origin --tags