ExoJulia

KO | EN

gitlite — search

#ai #llm #golang #go #android #machine-learning #rust #linux #java #cli #vue #awesome-list #ios #openai

(★ 10)

A Julia package for fast exoplanet modeling

ExoJulia Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ExoJulia <img src="https://github.com/jlustigy/ExoJulia/blob/master/Resources/proto1.png" width="13%" height="13%" align="left" />

**A Julia package for fast exoplanet modeling**

This code is being developed by Astronomy graduate students at the University of Washington for the course *ASTR 598A: Exoplanets*. The course and this project are led by [Professor Eric Agol](http://faculty.washington.edu/agol/index.html).

## ASTR 598A Collaboration Instructions

### Getting started

You should only need to perform the following once:

1. **Fork this repository** (click button in upper right of this page) to create a working branch on *your* github account.  If you need help with git/github, check out this 'Getting Started' page by [Phil Marshall:] (https://github.com/drphilmarshall/GettingStarted)

2. **Clone *your* fork** onto your computer:
  
  ```bash
  git clone https://github.com/YOUR_USERNAME/ExoJulia.git
  ```

3. Add *this* repo as an [upstream remote for your fork](https://help.github.com/articles/configuring-a-remote-for-a-fork/):

```bash
  git remote add upstream https://github.com/jlustigy/ExoJulia.git
  ```

3. Do HW assignments in the `Homework/` subdirectories (see below)

Now you can code on your machine and commit/push changes to your remote github repo without worrying about messing up or being messed up by other peoples work-in-progress code.

e.g. if you write a module over the course of a few days, it's nice to push to github a few times over those days to ensure you're backing everything up remotely. With git+github the dogs can hang around our homework, but they can never eat it. *Good dog*.

### Each week
1. [**Sync your fork** with the upstream branch](https://help.github.com/articles/syncing-a-fork/) to ensure that we are all writing code that uses the same ExoJulia package:

```bash
  git fetch upstream  
  git checkout master  
  git merge upstream/master  
  ```  
  This brings your fork's master branch into sync with the upstream repository, without losing your local changes.

2. Add, commit, push to your online fork (if you've made changes on your fork):

```bash
  git add .
  git commit -am "Message"
  git push origin master
  ```
    
2. **Create a unique homework directory**: `Homework\hw#\Name1_Name2` where "#" is the homework number, and "Name1" and "Name2" (and so forth) are the names of the group members. So each homework assignment will have a directory, within which each coding group will have a directory. This will ensure everyone's code is saved for future reference and will (hopefully) minimize merge conflicts that can occur when people have worked on the same files.  
3. **Write code** and work in Jupyter Notebooks within the directory you just created. Make sure to reference the "official" (previously selected) code if you are building on previous work. DO NOT LOAD MODULES FROM OTHER HOMEWORK DIRECTORIES.
4. **Add, commit, push** to your remote branch:
  
  ```bash
  git add .
  git commit -am "Message"
  git push origin master
  ```
  
5. **Submit pull request** by navigating to your fork on github.com and pressing the green button for "New Pull Request". This will request that your fork be "pulled" onto the Master branch. Since you've done all your work in a compeletly new directory (didn't you?) there won't be any issues merging :) 
6. Each week the fastest code (and then cleanist in the case of ties?) will be selected to become the "offical" code in the ExoJulia package.

### Finding the fastest functions for the `ExoJulia` package

Owen wrote an awesome [script](https://github.com/jlustigy/ExoJulia/blob/master/Homework/stest.sh) that will evaluate the runtime for all of our code.

* In order for the code to run on your functions, put the following line in a comment at the top of a `*.jl` file that contains the function you want to test:

```julia
  #@stest func(params)
  ```

For instance,

```julia
  # Suppose this is 'demo.jl'
  
  # The following line tells the stest script to run the function, func() with an argument of 0.5
  #@stest func(0.5)
  
  # You can have multiple stests!
  #@stest func(0.9)
  
  function func(x)
    10.0^x  
  end
  ```
* We will need to discuss as a class standard parameters to use to that we are truely comparing apples to apples.

* To test the runtime of a function using this script (always good to check before submitting a pull request), navigate to the `Homework/` directory and execute the bash script:

```bash
  ./stest hw1
  ```
  
  or `hw2`, `hw3`, etc.

## Coding Conventions

* See the [Julia progamming style guide](http://docs.julialang.org/en/release-0.4/manual/style-guide/)
* Write functions within `*.jl` files:  
  
  ```julia
  # Suppose this is 'function.jl'
  function func()
    # Epic code here!
  end
  ```
  
* `include` functions in other/test `*.jl` files:  
  
  ```julia
    include("function.jl")
    func()
  ```

* For using functions that have been merged into the official ExoJulia package:
  
  ```julia
  # Add ExoJulia/ to path
  push!(LOAD_PATH, "/PATH/TO/ExoJulia/ExoJulia")
  
  # import ExoJulia
  using ExoJulia
  
  # Run code!
  x = ExoJulia.Orbit.kepler_solve(0.5, 0.5)
  ```
  
* Remember to add the line to test the runtime of your functions! `#@stest func(params)`
* **Working on a new branch:** See [Astropy example of workflow](http://docs.astropy.org/en/stable/development/workflow/development_workflow.html#workflow) 
  * On the command line in your ExoJulia directory, get the latest version of `ExoJulia`: 
  
    ```bash
    git fetch upstream
    ```

* Now, create a new branch:
    
    ```bash
    git checkout -b newbranch
    ```
  
  * Do work on `newbranch`
  * Add, commit, and then push the `newbranch` to `origin`:
    
    ```bash
    git push origin newbranch
    ```
    
  * Now you can submit pull request on the github webpage from `newbranch` to `master`

ExoJulia

ExoJulia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ExoJulia

ExoJulia Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README