# EXPLAIN EXTENDED

How to create fast database queries

## Happy New Year: view of Earth from space in SQL

It's been a really long year.

The blog has not been updated during this year. I focused on improving my SQL skills and helping other folks to improve theirs.

During this year Explain Extended has become a team. We now do SQL consulting and database development. I'll write a post about it soon, but send me a message if you're impatient to wait.

Now, to the new year post.

New Year has always seemed like the most global thing to me. It does not happen to everyone at once. When I was a kid I wanted to go to space and see the New Year marching through the planet with my own eyes (and it's not that I don't want it anymore).

Now we have satellite images and such, but with a little effort we can see how our planet looks from space using SQL.

To do this, we need some map data, basic math and pretty simple SQL. I'll use PostgreSQL for that.

### Data

We would need some basic outlines of continents and major islands. A brief googling tells that kind folks at http://www.naturalearthdata.com/ have made it available in public domain. We would just need to go there and download the land area polygons in ESRI Shapefile format by this link.

To load that into the database I would have to create a table:

```CREATE TABLE
land
(
id INT PRIMARY KEY,
path PATH NOT NULL
);
```

and write a simple python script to convert ESRI files to something PostgreSQL would understand:

```import shapefile

print "INSERT\nINTO\tland\nVALUES\t\n" + ",\n".join(
[
"\t(" + str(i + 1) + ", '" + ", ".join(
[
"(" + ", ".join(
[
str(round(c, 2))
for c in p
]
) +
")"
for p in b.points[:-1]
]
) +
"'::PATH)"
for i, b in enumerate(sf.shapes())
]
) + ";\n"
```

This gives us 127 polygons of 5016 points in total. It's quite a large query so if you can't reproduce the steps above see it on Gist here.

### Showing the map

To show the map we would use some kind of a map projection. I'm not a map expert so I had to spent some time in research but it turned out that General Perspective Projection is what we need. As the Wikipedia article on the subject says, "when the Earth is photographed from space, the camera records the view as a perspective projection". That's pretty fine with me.

To render the Earth view on a "grid" we would need to provide some parameters: our coordinates, elevation, angle of view and screen resolution. Each point of the grid would correspond to some point on the Earth surface (identified by its coordinates).

If we were looking from above the North pole, the coordinates would map in a pretty straightforward way. It's simplest to work with the polar coordinates from the center of grid. Thus, `φ` maps directly into longitude, and `R` maps into the angle between the grid point and the point of view: `β = ATAN(TAN(angle_of_view) * (grid_width / R))`.

The point of view, the Earth center and the observed point on Earth form a triangle of which we know the two sides (distance from the center of the Earth and the Earth's radius) and the non-included angle `β`. We are interested in the angle between the two sides which would map into the complement to the latitude. The formula for this is `γ = ASIN((height + radius) / radius * SIN(β))`.

If we are not on the pole we would need to translate the points. Now, `φ` becomes bearing and `γ` becomes arc distance from our location. The translation formulae are:

``` LAT2 = ASIN(SIN(LAT1) * COS(γ) + COS(LAT1) * SIN(γ) * cos(φ)) LON2 = LON1 + ATAN2(SIN(φ) * SIN(γ) * COS(LAT1), COS(γ) − SIN(LAT1) * SIN(LAT2)) ```

Now, we just need to put it into the query and observe our Earth from above Moscow:

string_agg
*****************
****** ******
****##### # ****
****########## ****
***################ ***
**################## **
***################### ***
**##################### **
***############### # # ***
**######### ###### #### ##### **
**######## ### ## ####### **
**######## #### # # ##### #### **
**###### ## # # # ###### ### **
**######## # ###### # ######## **
**############# # #### ### ####### **
* ############ ##### ### ######## *
** ######### ### ## ######## **
** ######## #### ######## # ## **
* # ### ####### ######### ### # *
** # ## ############ ################ # **
** # ## ############# # ################# # **
* ## ############# ####################### # *
** # ########### ##################### # **
* ###### # # ##################### # *
* # # ###################### *
** # ######################## # **
* ######################### *
** ## # # ###################### **
** # # ####################### # **
* # # ###################### # *
* #### ########################### *
** ####### ################################# **
** ###### # ################################# **
* ##### ###################################### *
* ## #### ######################################### *
* # # # ## ######################################### *
* ## ## ###################################### *
* ## # # ######################################## #*
* # # # ######################################### *
* ################x################################### *
* #################################################### *
* ## ################################################### *
* ######################################################## *
* ######################################################## *
* #### # ############################################### *
* ### # ####### ## ##### ############################# *
** ### # ## ##### ###### ############################## **
** # ####### # #### ### # ############################# **
* ############## #### # #### ########################### *
* ################ # # ########### #################### ### *
** ############### # ########### ################### # **
** ################# ################################ ###**
* ################## ############################ #*
** #################### # ############################ **
* ######################## ############################ ##*
* ##################################### ######### ######## *
** ##################################### ## ### ####### **
* ########################### ######### # #### *
** ############################ ######### #### #### **
** ########################### ############ ### **
* ############################ ############ ## *
** ########################## ########## **
** ######################### ######## **
* ####################### ###### *
** ###################### #### **
** ######################### **
** ###################### ### **
** ########################### **
** ########################## **
** ######################### **
*** ####################### ***
** #################### **
*** ################### ***
** ################## **
***################## ***
****############### ****
****############ ## ****
******###### ##******
*****************
81 rows fetched in 0.0009s (1.5156s)

or from above New York City:

string_agg
*****************
****** #######******
**** ###########****
**** ######## ####****
*** ## ## #######***
** # ########**
*** # #######***
** #######**
*** # #######***
** ## ############**
** # ## #############**
** ### #########**
** #### # # ### ##### **
** ## #### # ### ### ##### **
** ######## ### ###### #### ##### #**
* # ######## ### ######## ## ##########*
** # ####### ## ###### ######### ## ########**
** ######## ## # ####### ######## **
* ############ ## ####### ## ##########*
** ######## ## ### ###### ### ## #### # **
** ########### #### #### ########## **
* ############## # ## #### ### ### #*
** ################# ## #### # # #### #**
* ############### ## ### ## ##*
* ############## ## ## ## ## # ##*
** ############ ## # ## #####**
* ############# ### #### ######*
** ############# ### # #### ######**
** ############# ###### ### ######**
* ################ ####### ##########*
* ################# ######### ########*
** ################## ######### ########**
** ############################ # ########**
* ######################### # ## #########*
* ######################## # ## ########*
* ############################# ########*
* ########################## # ########*
* ######################## ########*
* ######################## ########*
* ######################x ########*
* ###################### ########*
* # #################### ########*
* #################### #######*
* ################### #######*
* # ################ ###### *
* # ######## ###### ###### *
** ###### # #### **
** ##### ## ### **
* ##### # # *
* #### *
** #### **
** #### ### # **
* #### ## # *
** ###### ### **
* ## *
* ###### *
** ## **
* # *
** # ###### ## **
** #### ########### **
* ################# *
** ################## **
** ################## # #### **
* ############################ *
** ############################ **
** ############################ **
** ########################### **
** ########################## **
** ######################### **
** ####################### **
*** ####################### ***
** #################### **
*** ################ ***
** ############# **
*** ############ ***
**** ###########****
**** #########****
****** #####******
*****************
81 rows fetched in 0.0010s (1.4531s)

or from above Christmas Island:

string_agg
*****************
******#############******
****#####################****
****######################### ****
***############################## ***
**################################## **
***################################## ***
**#################################### **
*** ################################### ## ***
** ############################### ### **
**# ############################## # **
**# ################################# # ## **
**# ################################# #### **
**##################################### ## **
**####################################### **
*######################################## *
**####################################### **
**## #################################### **
*### # ############################# # *
**### # ########## ########## # **
**####### ####### ######## ## **
* ####### ###### ######## # *
** ###### ##### ######### # **
*# ##### #### ####### # *
*# ### #### ####### # *
**# ### ### # ### **
*## # ## # # *
**### # # # # **
**## # # # # **
*###### # ## ### *
*##### # # ## *
**##### ## # ##### **
**##### ### ##### ### **
*##### ### ##### # # *
*##### ### ##### ## ## *
*#### ## # ### *
*### # #### *
*### #### #### # *
*### # # ##### # *
*### x # ## # *
*## # # *
*### #### *
*### # #### # *
*### ####### # *
*#### ######### ## *
*#### ## ############## *
**### ## ################# **
**### ## #################### **
*### ## #################### *
*## ## #################### # *
**# ## ##################### **
**## # #################### **
*## # #################### *
**## #################### **
*# ##### ######### *
*## ######### *
**# ####### **
*# ##### *
**# #### **
** **
* *
** # # **
** **
* # *
** # **
** **
** **
** **
** **
** **
*** ***
** **
*** ############# ***
** #### ################ **
*** ##### ################## ***
****######################### ****
****################## ****
******########### ******
*****************
81 rows fetched in 0.0009s (1.4531s)
Happy New Year!

Previous New Year posts:

Written by Quassnoi

December 31st, 2012 at 11:00 pm

### 2 Responses to 'Happy New Year: view of Earth from space in SQL'

1. Nice query! What tool do you use to show the output of your queries? I installed PostgreSQL on Win 7, and it comes with psql which is a basic command line tool to run queries.

Tyler

17 Jan 13 at 08:40

2. @Tyler: that’s what I use, psql. I just copy its output and paste into the post.

Quassnoi

17 Jan 13 at 10:25