Submit Measurements

Submit Measurements

Copying to Your Data Directory

Before anyone can pull your data to somewhere useful, you must copy it to your personal data directory in your home directory which you made here. For the purposes of eUCLID, we are only interested in the .rt file associated with the CME you measured. To copy this file to the data directory enter the following command while in uhurub

cp ~/[insert name of .rt file] ~/[your personal letter]data

Aliases

You cannot copy files from uhurub to our local computer without going through kona. Therefore, we created aliases to easily bring files from uhurub to kona then from kona to your local computer.

On kona you should create a folder called data and within that folder you should have each of the personal data folders. There are also aliases that only secure copy one person’s folder (ex. scpadata, scpcdata, scpjdata, etc.) instead of everyone’s folder (sdall) to make the process faster.

Then you have to use the local alias, scpdata, to bring the data folder on kona to our local git repository.

Kona Aliases

# You can set up aliases for individual people's data directories with this alias
alias scp[their letter]data='scp -r [your username]@uhurub.ccmc.gsfc.nasa.gov:/home/[their username]/gcs_outputs/[their letter]data [your username]@kona.ccmc.gsfc.nasa.gov:/home/[your username]/data'

#You can also combine these together into one alias that will pull everyone's data
#Here is an example of Rachel's sdall alias
alias sdall='scp -r [email protected]:/home/rbroemme/gcs_outputs/rdata [email protected]:/home/rbroemme/data/; scp -r [email protected]:/home/kgootkin/gcs_outputs/kdata [email protected]:/home/rbroemme/data/; scp -r [email protected]:/home/mcrawfo2/gcs_outputs/cdata [email protected]:/home/rbroemme/data/; scp -r [email protected]:/home/askippe1/gcs_outputs/adata [email protected]:/home/rbroemme/data; scp -r [email protected]:/home/jyim1/gcs_outputs/jdata [email protected]:/home/rbroemme/data'

Local Aliases

Create these aliases on your normal laptop (may be difficult for Windows users so you may have to type in the actual command)

alias scpdata='scp -r [your username]@kona.ccmc.gsfc.nasa.gov:/home/[your username]/data [where you want to store your data]'

Submitting to GitHub

After using the aliases created above, you should be able to get your data directory onto your local machine. From here you will need to add your new measurements to this GitHub repository. The best way to do this will be using Git commands. If you are unsure how to get Git commands running on your machine here is a helpful guide.

Setting Up Your Repository

To set up the repository all you need to do is enter the terminal where you run Git commands and enter the following commands.

cd [Path to where the repository should go]
git clone https://github.com/KeyanGootkin/GCS-Benchmarking.git

This will place a folder called "GCS-Benchmarking" into the directory you choose to cd into. Once this directory is set up, you can change the data section by replacing your old data folder with one that you pull from uhurub.

Committing to GitHub

Git will keep track of any changes made to your local copy of the repository, such as adding data. You can check what changes have been made by entering the following command while in GCS-Benchmarking

git status

If there are any changes then you will need to "add" them. This prepares them to be committed. After you add them you can still make changes.

git add [file name 1] [file name 2] ...

Once you have added all the changes you want to keep, you have to commit. To do this enter the following the command.

git commit -m "[some commit message]"

Your commit message should be written in the present tense and describe what changes you are making. For example:

git commit -m "Adding data for the 2018-01-23 CME"

The final step is to "push" your commit to GitHub. This final step will add any changes that you made on your local machine to the shared GitHub repository. To push enter the following command.

git push origin master