<commit_before># What is CartoDB? #

[![Build Status](http://travis-ci.org/CartoDB/cartodb.png)]
(http://travis-ci.org/CartoDB/cartodb)
[![Code Climate](https://codeclimate.com/github/CartoDB/cartodb20.png)](https://codeclimate.com/github/CartoDB/cartodb20)

CartoDB is an open source tool that allows for the storage and
visualization of geospatial data on the web.

It was built to make it easier for people to tell their stories by
providing them with flexible and intuitive ways to create maps and design
geospatial applications. CartoDB can be installed on your own server
and we also offer a hosted service at [cartodb.com](http://cartodb.com).

If you would like to see some live demos, check out our
[videos](http://www.vimeo.com/channels/cartodb) on Vimeo.
We hope you like it!

![Map View](http://cartodb.s3.amazonaws.com/github/map_view.png)


# What can I do with CartoDB? #

With CartoDB, you can upload your geospatial data (Shapefiles, GeoJSON,
etc) using a web form and then make it public or private.

After it is uploaded, you can visualize it in a table or on a map, search
it using SQL, and apply map styles using CartoCSS. You can even access it
using the CartoDB [API OVERVIEW](http://developers.cartodb.com/documentation/apis-overview.html)
and [SQL API](http://developers.cartodb.com/documentation/sql-api.html), or export it
to a file.

In other words, with CartoDB you can make awesome maps and build
powerful geospatial applications! Definitely check out the [CartoDB
Develop](http://cartodb.com/develop) for interactive examples
and code.

![Map View Wizard](http://cartodb.s3.amazonaws.com/github/map_view_wizard.png)
![Data View](http://cartodb.s3.amazonaws.com/github/data_view.png)

# What are the components of CartoDB? #

  - A User Interface for uploading, creating, editing, visualizing,
    and exporting geospatial data.
  - A geospatial database built on PostgreSQL and PostGIS 2.1
  - An SQL API for running SQL queries over HTTP with results formatted
    using GeoJSON and KML
  - A Map tiler that supports SQL and tile styling using CartoCSS
  - Authentication using OAuth if required

# What does CartoDB depend on? #

  - Ubuntu 12.04
  - Postgres 9.3.x (with plpythonu extension)
  - [cartodb-postgresql](https://github.com/CartoDB/cartodb-postgresql) extension
  - Redis 2.2+
  - Ruby 1.9.3
  - Node.js 0.10.x
  - CartoDB-SQL-API
  - GEOS 3.3.4
  - GDAL 1.10.x (Starting with CartoDB 2.2.0)
  - PostGIS 2.1.x
  - Mapnik 2.1.1
  - Windshaft-cartodb
  - Varnish 2.1+ (WARNING: must be < 3.0!)
  - ImageMagick 6.6.9+ (for the testsuite)

# How do I install CartoDB? #

This is README is intended for Ubuntu 12.04. This doesn't mean that it can't 
be installed in other Linux versions or OSX systems, but that it's guaranteed 
to work only in Ubuntu 12.04.
If anyone wants to share with us the installation process for any other system 
we will be more than happy to point it from this README.
That said, there are also many successful installations on Amazon EC2, Linode,
dedicated instances and development machines running OS X and Ubuntu 12.04+.

CartoDB is under heavy development. This means that at some point this README 
can fail at some point. If you detect it, please let us know and we will fix 
it as soon as we can. Also if you feel that something is wrong or even it's 
missing we will be also happy to fix it.

For any doubt about the process you can ask in our [Google 
Group](https://groups.google.com/forum/#!forum/cartodb)

If you want to give it a try, download CartoDB by cloning this repository:

```bash
$ git clone --recursive https://github.com/CartoDB/cartodb.git
```

Or you can just [download the CartoDB zip
file](https://github.com/CartoDB/cartodb/archive/master.zip).

## Add CartoDB PPAs ##

Add CartoDB Base PPA
```bash
sudo add-apt-repository ppa:cartodb/base
```

Add CartoDB GIS PPA
```bash
sudo add-apt-repository ppa:cartodb/gis
```<commit_msg>Update wording in README<commit_after># What is CartoDB? #

[![Build Status](http://travis-ci.org/CartoDB/cartodb.png)]
(http://travis-ci.org/CartoDB/cartodb)
[![Code Climate](https://codeclimate.com/github/CartoDB/cartodb20.png)](https://codeclimate.com/github/CartoDB/cartodb20)

CartoDB is an open source tool that allows for the storage and
visualization of geospatial data on the web.

It was built to make it easier for people to tell their stories by
providing them with flexible and intuitive ways to create maps and design
geospatial applications. CartoDB can be installed on your own server
and we also offer a hosted service at [cartodb.com](http://cartodb.com).

If you would like to see some live demos, check out our
[videos](http://www.vimeo.com/channels/cartodb) on Vimeo.
We hope you like it!

![Map View](http://cartodb.s3.amazonaws.com/github/map_view.png)


# What can I do with CartoDB? #

With CartoDB, you can upload your geospatial data (Shapefiles, GeoJSON,
etc) using a web form and then make it public or private.

After it is uploaded, you can visualize it in a table or on a map, search
it using SQL, and apply map styles using CartoCSS. You can even access it
using the CartoDB [API OVERVIEW](http://developers.cartodb.com/documentation/apis-overview.html)
and [SQL API](http://developers.cartodb.com/documentation/sql-api.html), or export it
to a file.

In other words, with CartoDB you can make awesome maps and build
powerful geospatial applications! Definitely check out the [CartoDB
Develop](http://cartodb.com/develop) for interactive examples
and code.

![Map View Wizard](http://cartodb.s3.amazonaws.com/github/map_view_wizard.png)
![Data View](http://cartodb.s3.amazonaws.com/github/data_view.png)

# What are the components of CartoDB? #

  - A User Interface for uploading, creating, editing, visualizing,
    and exporting geospatial data.
  - A geospatial database built on PostgreSQL and PostGIS 2.1
  - An SQL API for running SQL queries over HTTP with results formatted
    using GeoJSON and KML
  - A Map tiler that supports SQL and tile styling using CartoCSS
  - Authentication using OAuth if required

# What does CartoDB depend on? #

  - Ubuntu 12.04
  - Postgres 9.3.x (with plpythonu extension)
  - [cartodb-postgresql](https://github.com/CartoDB/cartodb-postgresql) extension
  - Redis 2.2+
  - Ruby 1.9.3
  - Node.js 0.10.x
  - CartoDB-SQL-API
  - GEOS 3.3.4
  - GDAL 1.10.x (Starting with CartoDB 2.2.0)
  - PostGIS 2.1.x
  - Mapnik 2.1.1
  - Windshaft-cartodb
  - Varnish 2.1+ (WARNING: must be < 3.0!)
  - ImageMagick 6.6.9+ (for the testsuite)

# How do I install CartoDB? #

This README is intended for Ubuntu 12.04. This doesn't mean that it can't 
be installed on other Linux versions or OSX systems, but that it's guaranteed 
to work only in Ubuntu 12.04.
If anyone wants to share with us the installation process for any other system 
we will be more than happy to point it from this README.
That said, there are also many successful installations on Amazon EC2, Linode,
dedicated instances and development machines running OS X and Ubuntu 12.04+.

CartoDB is under heavy development. This means that this README 
can fail at some point. If see any issues, please let us know and we will fix 
them as soon as we can. Also if you feel that something is wrong or even
missing we will be happy to fix it.

For any doubt about the process you can ask in our [Google 
Group](https://groups.google.com/forum/#!forum/cartodb).

If you want to give it a try, download CartoDB by cloning this repository:

```bash
$ git clone --recursive https://github.com/CartoDB/cartodb.git
```

Or you can just [download the CartoDB zip
file](https://github.com/CartoDB/cartodb/archive/master.zip).

## Add CartoDB PPAs ##

Add CartoDB Base PPA
```bash
sudo add-apt-repository ppa:cartodb/base
```

Add CartoDB GIS PPA
```bash
sudo add-apt-repository ppa:cartodb/gis
```
{'fraction_non_alphanumeric': 0.08980737338946294, 'fraction_numerical': 0.01454267125908917, 'mean_word_length': 3.9061326658322906, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 3, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1607914', 'n_tokens_mistral': 2690, 'n_tokens_neox': 2464, 'n_words': 1007}