https://github.com/logue/pds2img

NASA Planetary Data System (PDS) to PNG/TIFF convertion library.
https://github.com/logue/pds2img

nasa-astronomy-picture nasa-data pds

Last synced: 22 days ago
JSON representation

NASA Planetary Data System (PDS) to PNG/TIFF convertion library.

• Host: GitHub
• URL: https://github.com/logue/pds2img
• Owner: logue
• License: mit
• Created: 2026-04-22T12:18:17.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-06-04T23:16:11.000Z (about 2 months ago)
• Last Synced: 2026-06-05T01:08:56.685Z (about 2 months ago)
• Topics: nasa-astronomy-picture, nasa-data, pds
• Language: TypeScript
• Homepage:
• Size: 2.49 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# 🛰️PDS2img

[![jsdelivr CDN](https://data.jsdelivr.com/v1/package/npm/pds2img/badge)](https://www.jsdelivr.com/package/npm/pds2img)

[![NPM Downloads](https://img.shields.io/npm/dm/pds2img.svg?style=flat)](https://www.npmjs.com/package/pds2img)

[![Open in unpkg](https://img.shields.io/badge/Open%20in-unpkg-blue)](https://uiwjs.github.io/npm-unpkg/#/pkg/pds2img/file/README.md)

[![npm version](https://img.shields.io/npm/v/pds2img.svg)](https://www.npmjs.com/package/pds2img)

[![Open in Gitpod](https://shields.io/badge/Open%20in-Gitpod-green?logo=Gitpod)](https://gitpod.io/#https://github.com/logue/pds2img)

[![Twitter Follow](https://img.shields.io/twitter/follow/logue256?style=plastic)](https://twitter.com/logue256)

![C3592903_RAW](C3592903_RAW.png)

[NASA Planetary Data System (PDS)](https://pds.nasa.gov/) to PNG/TIFF conversion library.

## Usage

PDS3 (Voyager, Galileo, Cassini, etc.)

```ts

import { loadPDS3ImageByUrl, toPNG, toTIFF } from 'pds2image';

const imgUrl = '/data/C3593229_RAW.IMG';

// Load and parse PDS3 product

const image = await loadPDS3ImageByUrl(imgUrl);

// Convert to PNG / TIFF ArrayBuffer

const pngBuffer = toPNG(image);

const tiffBuffer = toTIFF(image);

```

PDS4 (Modern spacecraft image)

```ts

import { loadPDS4ImageByUrl, toPNG, toTIFF } from 'pds2image';

const xmlUrl =

  '/data/FLG_1739_0821318674_675RAS_N0830000FHAZ00505_0A01I4J01.xml';

const imgUrl =

  '/data/FLG_1739_0821318674_675RAS_N0830000FHAZ00505_0A01I4J01.IMG';

// Load and parse PDS4 product

const image = await loadPDS4ImageByUrl(xmlUrl, imgUrl);

// Convert to PNG / TIFF ArrayBuffer

const pngBuffer = toPNG(image);

const tiffBuffer = toTIFF(image);

```

PDS4 (File System Access API)

```ts

import { loadPDSImageArrayBufferFromDirectory } from 'pds2image';

// Browser only: user picks a directory that contains .xml + referenced .IMG

const directoryHandle = await window.showDirectoryPicker();

const float32Buffer =

  await loadPDSImageArrayBufferFromDirectory(directoryHandle);

console.log(float32Buffer.byteLength);

```

Save PNG / TIFF in browser

```ts

function saveArrayBuffer(

  buffer: ArrayBuffer,

  mimeType: string,

  filename: string,

): void {

  const blob = new Blob([buffer], { type: mimeType });

  const url = URL.createObjectURL(blob);

  const anchor = document.createElement('a');

  anchor.href = url;

  anchor.download = filename;

  anchor.click();

  URL.revokeObjectURL(url);

}

// Example usage with previous PDS4 sample variables

saveArrayBuffer(pngBuffer, 'image/png', 'pds4-output.png');

saveArrayBuffer(tiffBuffer, 'image/tiff', 'pds4-output.tiff');

```

Save PNG / TIFF with user-selected location (File System Access API)

```ts

async function saveArrayBufferWithPicker(

  buffer: ArrayBuffer,

  mimeType: string,

  suggestedName: string,

): Promise {

  // Fallback for browsers that do not support File System Access API

  if (!('showSaveFilePicker' in window)) {

    const blob = new Blob([buffer], { type: mimeType });

    const url = URL.createObjectURL(blob);

    const anchor = document.createElement('a');

    anchor.href = url;

    anchor.download = suggestedName;

    anchor.click();

    URL.revokeObjectURL(url);

    return;

  }

  const handle = await window.showSaveFilePicker({

    suggestedName,

    types: [

      {

        description: mimeType,

        accept: {

          [mimeType]: [suggestedName.endsWith('.tiff') ? '.tiff' : '.png'],

        },

      },

    ],

  });

  const writable = await handle.createWritable();

  await writable.write(buffer);

  await writable.close();

}

// Example usage with previous PDS4 sample variables

await saveArrayBufferWithPicker(pngBuffer, 'image/png', 'pds4-output.png');

await saveArrayBufferWithPicker(tiffBuffer, 'image/tiff', 'pds4-output.tiff');

```

CLI

```bash

# Build library first (CLI reads from dist/)

pnpm run build

# PDS3 example (creates C3592903_RAW.png)

bin/pds2img -i C3592903_RAW -type png

# Explicit input path and output path

bin/pds2img -i ./tests/data/C3592903_RAW -type tiff -o ./tests/data/out.tiff

# Directory mode: convert all supported datasets in a directory

bin/pds2img -d ./tests/data -type png

# Directory mode with explicit output directory

bin/pds2img -d ./tests/data -type tiff -o ./tests/out

```

Notes:

- `-i` accepts a base path (`C3592903_RAW`), `.IMG` path, or `.xml` path.

- `-d` converts all datasets in a directory: PDS3 (`.IMG + .LBL`) and PDS4 (`.xml`).

- Detection order for base path input is PDS3 (`.IMG + .LBL`) then PDS4 (`.xml`).

- In directory mode, `-o` is treated as an output directory.

- On Windows PowerShell, run `./bin/pds2img.cmd ...`.

## Setup

Install the dependencies:

```bash

pnpm install

```

## Get started

Build the app for production:

```bash

pnpm run build

```

## License

©2026 by Logue.

Licensed under the [MIT License](LICENSE).