Code Monkey home page Code Monkey logo

laboratoryofcomputationalphysics_y3's Introduction

LaboratoryOfComputationalPhysics

Notebooks guiding students through the world of data analysis with python.

This repo should be forked by each individual student. Exercises should be committed to the student's repo and notified to the professor by a pull request. Such pull request should be made on this remote repo under the corresponding student branch (Dedicated branches will indeed be created in due time).

IPython notebooks instructions and tips

Notebooks are extremely powerful tools, you may find useful to discover some of their functionalities on this tutorial page or on this by checking this list of tips

Git Instructions

To start with, you need to have a github account. If you don't have one, go to github and follow instructions on how to create it.

Suggestion: use a reasonable username that resembles your actual name.

Once you have your github, as first thing fork this repository, i.e. go there and click on the top-right button fork

Setting up a local repository

What follows needs to be done any time a new local repository is created. In particular, if you are working in a location where such repo already exist, what follows doesn't need to be repeated.

  • Clone your (forked) repository (i.e. create a local repository cloned from the remote one)

git clone https://github.com/YOUR_GIT_ACCOUNT/LaboratoryOfComputationalPhysics_Y3.git

where YOUR_GIT_ACCOUNT it your account on github. Now you can get to your local working folder:

cd LaboratoryOfComputationalPhysics_Y3/

  • Configure your username and email:

git config --global user.name "YOUR_GIT_ACCOUNT"

git config --global user.email "YOUR_EMAIL_ADDRESS"

(you must have understood what capital-letters-words stand for). Your git configuration is stored in .gitconfig, a file that you can alwasy edit by hand or via the git config .. commands.

  • Define PhysicsOfData's repo as the upstream repository (you may need to set the url too), check that actually succeeded and get (fetch) the updates that have been done on the remote repository:

git remote add upstream https://github.com/PhysicsOfData/LaboratoryOfComputationalPhysics_Y3.git

git remote set-url origin https://[email protected]/YOUR_GIT_ACCOUNT/LaboratoryOfComputationalPhysics_Y3.git

git remote -v

git fetch upstream

  • The default branch is master, you should now create your development branch where to play and exercise with the code. Note that however you have a branch corresponding to you (name_surname) in the upstream repository (upstream/name_surname): that is the branch you should point the pull request to. In order to set up a proper development cycle, you must create a branch (in the example below called TRACKING_BRANCH_NAME) that tracks upstream/name_surname:

git branch -vv

git checkout -b TRACKING_BRANCH_NAME upstream/name_surname

Note that the case you decide do make your development in a branch that does NOT track upstream/name_surname, you'll eventually need to merge your changes into the branch tracking upstream/name_surname which is the one you'll make the pull request for (see later).

Standard development cycle

  • Before starting to develop on the machine that you are using, in order to update the work with the last changes (suppose you have made some change from your home computer), type the follow command

git pull

  • Before starting with the development you could check whether the orginal repository (PhysicsOfData's one) have been updated with respect to your forked version (that's likely to be the case prior to every lab class). If it had, then merge the chances into your master.

git fetch upstream

git checkout master

git merge upstream/master

The idea is that your master always reflects upstream/master, i.e. it keeps a local copy of the reference code as a starting point for your developments (i.e. solving the assigned problems). Note that in order to update your repository on github, you need to push the local version (see later).

  • In the case a pull request of yours to PhysicsOfData has been recently approved, you also need to synch your development branch:

git checkout TRACKING_BRANCH_NAME

git merge upstream/name_surname

  • You may also need to get the updates from the master, i.e. need to merge the master:

git merge master

  • Now do the real stuff, i.e. developing some code. Image you create a NEW_FILE. Add the file to your local repository and stages it for commit (To unstage a file, use 'git reset HEAD NEW_FILE)'

git add NEW_FILE

  • Commits the (tracked) changes you made to the file and prepares them to be pushed to your remote repository on github

git commit -m "Add existing file"

(what follows after -m is a comment to later remind what was that commit about)

  • Now you want to propagate (push) your local changes to your remote repository on github (origin)

git push origin TRACKING_BRANCH_NAME

  • Finally you may want to propagate your development also to the repo you originally forked from, i.e. PhysicsOfData's one (this is likely to happen anytime you'll be asked to deliver your homework!). For that you need to go for a "pull request", which is done from github itself. Be carefull to point your pull request to PhysicsOfData/name_surname

laboratoryofcomputationalphysics_y3's People

Contributors

alecas93 avatar physicsofdata avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.