<commit_before># Astronomy

Get information using a simple interface about various celestial phenomena from [Freebase](http://freebase.com) including:

- Asterisms
- Celestial Objects
- Stars
- Planets
- Star Systems
- Celestial object with coordinate systems
- Asteroid Groups
- Galaxies
- Bodies with heliocentric orbits
- Moons
- Comets
- Asteroids
- Constellations
- Nebulae
- Natural satellites
- Astronomical Discoveries
- Galactic superclusters
- Globular clusters
- Supernovae
- Galactic filaments
- Meteor Showers

For example, here is the entry on the Big Dipper:

    {
                 "name" => "<NAME>",
          "description" => "The Big Dipper, also known as the Plough, is an asterism of seven stars recognized as a distinct grouping in many cultures. These stars are the brightest of the formal constellation Ursa Major; six of them are second magnitude stars, while only Megrez is of third magnitude. The North Star, the current northern pole star on Earth, can be located by extending an imaginary line from Merak through Dubhe. Polaris is part of the \"Little Dipper\", Ursa Minor.",
               "images" => [
            [0] "https://usercontent.googleapis.com/freebase/v1/image/m/02dd6yz",
            [1] "https://usercontent.googleapis.com/freebase/v1/image/m/04shvsk"
        ],
        "detailed_info" => "https://www.googleapis.com/freebase/v1/topic/m/09csbt"
    }

Search over 600K of user curated data.

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'astronomy'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install astronomy

## Usage

Get all of the data as a hash:

```ruby
info = Astronomy::Information.new
info.data
```

Get a full list of categories:

```ruby
info = Astronomy::Information.new
info.categories
```

Get a list of topics from a given category:

```ruby
info = Astronomy::Information.new
info.topics 'Galactic supercluster'
```

Search both names and descriptions:

```ruby
info = Astronomy::Information.new
info.search 'moon'
```

## Contributing

1. Fork it ( https://github.com/[my-github-username]/astronomy/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request
<commit_msg>Add instructions on how to obtain larger images<commit_after># Astronomy

Get information using a simple interface about various celestial phenomena from [Freebase](http://freebase.com) including:

- Asterisms
- Celestial Objects
- Stars
- Planets
- Star Systems
- Celestial object with coordinate systems
- Asteroid Groups
- Galaxies
- Bodies with heliocentric orbits
- Moons
- Comets
- Asteroids
- Constellations
- Nebulae
- Natural satellites
- Astronomical Discoveries
- Galactic superclusters
- Globular clusters
- Supernovae
- Galactic filaments
- Meteor Showers

For example, here is the entry on the Big Dipper:

    {
                 "name" => "Big Dipper",
          "description" => "The Big Dipper, also known as the Plough, is an asterism of seven stars recognized as a distinct grouping in many cultures. These stars are the brightest of the formal constellation Ursa Major; six of them are second magnitude stars, while only Megrez is of third magnitude. The North Star, the current northern pole star on Earth, can be located by extending an imaginary line from Merak through Dubhe. Polaris is part of the \"Little Dipper\", Ursa Minor.",
               "images" => [
            [0] "https://usercontent.googleapis.com/freebase/v1/image/m/02dd6yz",
            [1] "https://usercontent.googleapis.com/freebase/v1/image/m/04shvsk"
        ],
        "detailed_info" => "https://www.googleapis.com/freebase/v1/topic/m/09csbt"
    }

Search over 600K of user curated data.

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'astronomy'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install astronomy

## Usage

Get all of the data as a hash:

```ruby
info = Astronomy::Information.new
info.data
```

Get a full list of categories:

```ruby
info = Astronomy::Information.new
info.categories
```

Get a list of topics from a given category:

```ruby
info = Astronomy::Information.new
info.topics 'Galactic supercluster'
```

Search both names and descriptions:

```ruby
info = Astronomy::Information.new
info.search 'moon'
```

*Hint:*

If you find images are too small appending a query string with optional parameters: maxwidth and / or maxheight.

For example:

https://usercontent.googleapis.com/freebase/v1/image/m/02dd6yz?maxwidth=500&maxheight=400

## Contributing

1. Fork it ( https://github.com/[my-github-username]/astronomy/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

{'fraction_non_alphanumeric': 0.09698795180722891, 'fraction_numerical': 0.010040160642570281, 'mean_word_length': 3.5992613111726683, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 12, 'https://': 9, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3761393', 'n_tokens_mistral': 1554, 'n_tokens_neox': 1424, 'n_words': 564}