# Search and Discovery

> Find and explore celestial objects in the Nyx universe

This guide covers all search and discovery features in Nyx, from quick name
lookups to advanced filtered searches across millions of objects.

## Table of Contents

1. [Quick Search](#quick-search)
2. [Advanced Search](#advanced-search)
3. [Catalog Browsing](#catalog-browsing)
4. [Discovery Features](#discovery-features)
5. [Tonight's Sky](#tonights-sky)
6. [Event Finder](#event-finder)
7. [Personal Lists](#personal-lists)

---

## Quick Search

### Opening Quick Search

- Press `/` or `Ctrl/Cmd + K`
- Click the search icon in the toolbar
- Start typing anywhere (if quick search mode enabled)

### Search Bar Interface

```
┌─────────────────────────────────────────────────────────────┐
│ 🔍 Search stars, planets, galaxies...                       │
├─────────────────────────────────────────────────────────────┤
│ Recent: M31 • Betelgeuse • Jupiter • NGC 7000               │
└─────────────────────────────────────────────────────────────┘
```

### What You Can Search

| Query Type     | Examples                            |
| -------------- | ----------------------------------- |
| Common names   | "Andromeda", "Betelgeuse", "Saturn" |
| Catalog IDs    | "M31", "NGC 224", "HD 206860"       |
| Bayer names    | "Alpha Centauri", "β Ori"           |
| Coordinates    | "10h 45m, +12°"                     |
| Object types   | "galaxy", "nebula", "double star"   |
| Constellations | "in Orion", "Orion constellation"   |
| Events         | "next eclipse", "ISS pass"          |

### Search Results

Results appear as you type with real-time filtering:

```
┌─────────────────────────────────────────────────────────────┐
│ 🔍 mars                                                      │
├─────────────────────────────────────────────────────────────┤
│ ● Mars                    Planet       Mag: -1.2   ↗ 45°    │
│ ⬡ 1 Ceres                 Dwarf Planet Mag: 8.4    ↗ 23°    │
│ ◎ Mars Global Surveyor    Spacecraft   -           N/A      │
│ ☁ IC 405 (Flaming Star)   Nebula       Mag: 6.0    ↗ 67°    │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│ Showing 4 of 12 results • [See all results →]               │
└─────────────────────────────────────────────────────────────┘
```

### Result Information

Each result shows:

- **Icon**: Object type indicator
- **Name**: Primary name
- **Type**: Object classification
- **Magnitude**: Visual brightness
- **Altitude**: Current position (↗ = above horizon, ↘ = below)

---

## Advanced Search

### Opening Advanced Search

- Press `Ctrl/Cmd + Shift + F`
- Click "Advanced" in the search bar
- Select Search > Advanced Search from menu

### Filter Categories

#### Object Type Filters

```
☑ Stars
  ☑ Single stars
  ☑ Double/multiple stars
  ☑ Variable stars
  ☐ Carbon stars
☑ Solar System
  ☑ Planets
  ☑ Dwarf planets
  ☑ Moons
  ☑ Asteroids
  ☐ Comets
☑ Deep Sky
  ☑ Galaxies
  ☑ Nebulae
  ☐ Open clusters
  ☐ Globular clusters
☐ Artificial
  ☐ Satellites
  ☐ Space stations
  ☐ Debris
```

#### Property Filters

| Filter          | Range/Options          |
| --------------- | ---------------------- |
| Magnitude       | -30 to +30 (slider)    |
| Distance        | 0 AU to 1B light years |
| Size            | Arcseconds to degrees  |
| Constellation   | Dropdown list          |
| Right Ascension | 0h - 24h               |
| Declination     | -90° to +90°           |
| Altitude (now)  | -90° to +90°           |

#### Observability Filters

```
☑ Currently visible (above horizon)
☑ Best observed tonight
☐ Observable this month
☐ Circumpolar from my location
☑ Magnitude within equipment limit: [8.0]
```

### Search Query Builder

Build complex queries visually:

```
┌─────────────────────────────────────────────────────────────┐
│ Find objects where:                                          │
│                                                              │
│ [Type ▼] [is ▼] [Galaxy ▼]                          [+ Add] │
│   AND                                                        │
│ [Magnitude ▼] [is less than ▼] [10.0]               [× Del] │
│   AND                                                        │
│ [Constellation ▼] [is one of ▼] [Virgo, Coma ▼]    [× Del] │
│                                                              │
│ [Search] [Save as Smart List] [Clear]                        │
└─────────────────────────────────────────────────────────────┘
```

### Saved Searches

Save frequently used search criteria:

1. Configure your search filters
2. Click "Save as Smart List"
3. Name your search (e.g., "Bright Galaxies in Spring")
4. Access later from Lists > Smart Lists

---

## Catalog Browsing

### Available Catalogs

| Catalog          | Objects     | Coverage                      |
| ---------------- | ----------- | ----------------------------- |
| **Messier**      | 110         | Brightest DSOs                |
| **NGC**          | 7,840       | New General Catalogue         |
| **IC**           | 5,386       | Index Catalogue               |
| **Caldwell**     | 109         | Southern & challenging DSOs   |
| **Herschel 400** | 400         | Advanced observer's list      |
| **Hipparcos**    | 118,218     | Bright stars with parallax    |
| **Gaia DR3**     | 1.8 billion | All-sky stellar survey        |
| **Exoplanets**   | 5,500+      | Confirmed exoplanets          |
| **Satellites**   | 25,000+     | Tracked artificial satellites |

### Browsing a Catalog

1. Go to Catalogs menu
2. Select a catalog
3. View the sortable, filterable list

```
┌─────────────────────────────────────────────────────────────┐
│ Messier Catalog                              [Filter] [Sort]│
├─────────────────────────────────────────────────────────────┤
│ ID   │ Name              │ Type      │ Mag  │ Const │ ☑    │
├──────┼───────────────────┼───────────┼──────┼───────┼──────┤
│ M1   │ Crab Nebula       │ SNR       │ 8.4  │ Tau   │ ☐    │
│ M2   │                   │ Globular  │ 6.5  │ Aqr   │ ☑    │
│ M3   │                   │ Globular  │ 6.2  │ CVn   │ ☐    │
│ M4   │                   │ Globular  │ 5.9  │ Sco   │ ☐    │
│ M5   │                   │ Globular  │ 6.7  │ Ser   │ ☐    │
│ ...  │                   │           │      │       │      │
├─────────────────────────────────────────────────────────────┤
│ Showing 1-25 of 110 │ ☑ = Observed                          │
└─────────────────────────────────────────────────────────────┘
```

### Catalog Completion Tracking

Track your progress through catalogs:

- **Observed**: Objects you've logged
- **Attempted**: Tried but conditions poor
- **Remaining**: Not yet observed
- **Not visible**: Below horizon limit from your location

---

## Discovery Features

### "What's That?" Mode

Identify objects in the real sky:

1. Click the "?" button or press `I`
2. Point to any star/object on the map
3. See instant identification
4. Works with AR camera mode too

### Object of the Day

Daily featured object with:

- Detailed description
- Best viewing tips
- Historical significance
- Professional imagery

### Similar Objects

When viewing any object, find similar ones:

```
Objects similar to M31 (Andromeda Galaxy):
├── M33 (Triangulum Galaxy) - 14° away, similar type
├── NGC 253 (Sculptor Galaxy) - spiral galaxy, similar size
├── M81 (Bode's Galaxy) - grand design spiral
└── [Show 45 more similar objects...]
```

### Observing Challenges

Structured discovery programs:

| Challenge           | Objects | Difficulty | Badge              |
| ------------------- | ------- | ---------- | ------------------ |
| Messier Marathon    | 110     | Medium     | 🏆 Messier Master  |
| Herschel 400        | 400     | Hard       | 🔭 Deep Sky Expert |
| Double Star Program | 100     | Easy       | ⭐ Star Splitter   |
| Lunar 100           | 100     | Easy-Med   | 🌙 Lunar Observer  |
| Urban Astronomer    | 50      | Easy       | 🌃 City Stargazer  |

---

## Tonight's Sky

### Visibility Panel

See what's observable tonight:

```
┌─────────────────────────────────────────────────────────────┐
│ Tonight's Sky - January 21, 2026                            │
│ Location: New York, NY │ Sunset: 17:03 │ Sunrise: 07:12     │
├─────────────────────────────────────────────────────────────┤
│ 🌓 Moon: First Quarter, 49% illuminated                     │
│    Sets 01:23, rises 11:45                                  │
├─────────────────────────────────────────────────────────────┤
│ PLANETS VISIBLE TONIGHT                                     │
│ ● Jupiter    Mag: -2.4   Best: 21:30   Alt: 67°            │
│ ● Saturn     Mag: +0.8   Best: 19:15   Alt: 23°            │
│ ● Mars       Mag: +1.2   Best: 03:45   Alt: 58°            │
├─────────────────────────────────────────────────────────────┤
│ RECOMMENDED DEEP SKY                                        │
│ ◎ M42        Orion Nebula       Mag: 4.0   Alt: 45° @ 22:00│
│ ◎ M31        Andromeda Galaxy   Mag: 3.4   Alt: 34° @ 20:00│
│ ◎ M45        Pleiades           Mag: 1.6   Alt: 72° @ 21:00│
├─────────────────────────────────────────────────────────────┤
│ [Create Observation Plan] [Export] [Subscribe to Alerts]    │
└─────────────────────────────────────────────────────────────┘
```

### Best Time Calculator

For any object, see optimal viewing window:

```
M42 - Orion Nebula
Visibility Tonight:
├── Rises: 18:45 (already up)
├── Transits: 23:12 (best time - highest altitude)
├── Sets: 03:41
└── Recommended window: 21:00 - 01:30 (good altitude)

Moon interference: Moderate (48% illuminated, 35° away)
Light pollution impact: Low (Bortle 4 conditions needed)
```

### Automatic Planning

Generate an optimized observation plan:

1. Select target objects
2. Set time constraints (start/end time)
3. Set equipment (limiting magnitude, tracking?)
4. Click "Generate Plan"

The planner considers:

- Object altitude throughout night
- Moon proximity and phase
- Object setting times
- Transition efficiency between targets

---

## Event Finder

### Upcoming Events

View astronomical events:

```
┌─────────────────────────────────────────────────────────────┐
│ Upcoming Events                              [Filter] [+Cal]│
├─────────────────────────────────────────────────────────────┤
│ TODAY                                                        │
│ ⏱ 18:45  Sunset                                             │
│ ⏱ 19:12  ISS Pass (Mag -3.2, 5 min, NW→SE)                 │
│ ⏱ 23:12  M42 transits (best viewing)                        │
│                                                              │
│ THIS WEEK                                                    │
│ 📅 Jan 22  First Quarter Moon                               │
│ 📅 Jan 24  Venus at greatest elongation                     │
│ 📅 Jan 25  Jupiter-Moon conjunction (2°)                    │
│                                                              │
│ THIS MONTH                                                   │
│ 📅 Jan 29  Full Moon "Wolf Moon"                            │
│ 📅 Feb 4   Mercury at greatest western elongation           │
│                                                              │
│ [Show all events...] [Set up alerts]                        │
└─────────────────────────────────────────────────────────────┘
```

### Event Types

| Category           | Examples                               |
| ------------------ | -------------------------------------- |
| **Solar System**   | Conjunctions, oppositions, elongations |
| **Eclipses**       | Solar, lunar, planetary                |
| **Occultations**   | Moon, planet, asteroid                 |
| **Meteor Showers** | Perseids, Geminids, Leonids            |
| **Satellites**     | ISS passes, Starlink trains            |
| **Variable Stars** | Eclipsing binary minima                |
| **Comets**         | Perihelion, visibility windows         |

### Event Alerts

Set up notifications for events:

1. Go to Settings > Notifications
2. Enable event categories
3. Set alert timing (1 hour before, 1 day before, etc.)
4. Choose delivery method (push, email, in-app)

---

## Personal Lists

### Creating Lists

Organize objects into custom lists:

```
My Lists
├── 📁 Observation Goals
│   ├── 📋 Winter Targets (23 objects)
│   ├── 📋 Galaxy Season (45 objects)
│   └── 📋 Double Stars (18 objects)
├── 📁 Completed
│   └── 📋 Messier Objects (87/110)
└── 📁 Imaging Projects
    └── 📋 Narrowband Targets (12 objects)
```

### List Operations

| Action            | Description                      |
| ----------------- | -------------------------------- |
| **Add object**    | Click + or drag from map         |
| **Remove object** | Swipe left or click ×            |
| **Reorder**       | Drag to rearrange                |
| **Sort**          | By name, magnitude, RA, altitude |
| **Filter**        | By visibility, observed status   |
| **Export**        | CSV, PDF, telescope format       |
| **Share**         | Generate shareable link          |

### Smart Lists

Dynamic lists that auto-update:

**Example smart lists:**

- "Visible tonight brighter than mag 8"
- "Unobserved Messier objects"
- "Galaxies in current field of view"
- "Objects transiting in next 2 hours"

### Observation Logging

Record your observations:

```
┌─────────────────────────────────────────────────────────────┐
│ Log Observation: M42 - Orion Nebula                         │
├─────────────────────────────────────────────────────────────┤
│ Date/Time: [2026-01-21 22:30] [Use current]                 │
│ Equipment: [8" Dobsonian ▼]                                 │
│ Eyepiece:  [25mm (48x) ▼]                                   │
│ Seeing:    [●●●○○] 3/5                                      │
│ Transparency: [●●●●○] 4/5                                   │
│                                                              │
│ Notes:                                                       │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Excellent view tonight. Trapezium clearly resolved.     │ │
│ │ Could see hints of M43 separation. Dark lane visible... │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                              │
│ [Attach Sketch] [Attach Photo] [Record Audio]               │
│                                                              │
│ [Save Observation] [Cancel]                                  │
└─────────────────────────────────────────────────────────────┘
```

---

## Tips for Effective Discovery

### Finding Challenging Objects

1. **Use the visibility filter** - Only show objects above your horizon
2. **Consider moonless nights** - Filter by moon phase
3. **Check transparency** - Some objects need dark skies
4. **Use star hopping** - Enable the path finder feature

### Maximizing Your Session

1. Create a list before your session
2. Sort by transit time
3. Start with objects setting soon
4. End with objects rising

### Discovering New Favorites

1. Explore the "Similar Objects" suggestions
2. Try the weekly challenges
3. Join community observing programs
4. Use the random object feature (`R` key)

---

## Next: [Educational Features](./educational-features.md)
