# Example Outputs
This directory contains example output files generated by the `map2fig` tool, demonstrating various features and use cases.
## Files
- **example1_mollweide.pdf** - Basic all-sky Mollweide projection with default settings
- **example2_log_scale.pdf** - Full-sky map with logarithmic scaling (log-scale data visualization)
- **example3_gnomonic_graticule.png** - Zoomed gnomonic projection with local coordinate grid
- **example4_overlay_graticule.pdf** - Gnomonic view with dual coordinate system overlays
- **example4b_roll.png** - Gnomonic projection with 45° rotation around the center
- **example4c_graticule_customization.png** - Customized graticule with thick lines and custom colors
- **example5_dual_graticules.pdf** - Mollweide with Galactic and Equatorial coordinate systems
- **example6_histogram_equalization.pdf** - Map with histogram equalization and dark background
- **example7_asinh_scaling.pdf** - Full-sky map with arcsinh scaling (good for symmetric data)
- **example8_symlog_scaling.pdf** - Full-sky map with symmetric logarithmic scaling
- **example9_latex_units.pdf** - Mollweide view with LaTeX-formatted colorbar units
## Preview Images
The `*_preview.png` files are lower-resolution versions created for display in the README.
## Generating Examples
All examples are generated from the `npipe_nodip.fits` file using the commands shown in the main README.md file. To regenerate these files after making changes to the code:
```bash
cd ..
./target/release/map2fig [command from README]
```
## Adding to Repository
These files are included in the repository to:
1. Show the expected output for each example command
2. Allow readers to see what the figures look like without running the tool
3. Provide baseline references for consistency testing in future development
## File Sizes
- PDF files: 20 KB - 2.2 MB (high-quality vector graphics)
- PNG files: 23 KB - 110 KB (raster graphics)
- Preview PNG files: ~15 KB each (web-optimized thumbnails)
## Updating Examples
When you update the tool or want to refresh examples:
1. Regenerate the output files with the updated tool
2. Update the preview PNG files (max 600×600 resolution)
3. Verify the image links in the main README.md still work
4. Commit the updated files with a descriptive message