GRASS logo

NAME

p.rings.stats - Compute azimuthal and radial statistics for a ring-plane raster.
Given a ring-plane raster (north=ring_radius, east=ring_lon), computes radial profile (mean DN vs ring radius) and azimuthal profile (mean DN vs ring longitude). Profiles are written to text files.

KEYWORDS

Planetary, Ring Plane Analysis, ring plane, statistics, Saturn

SYNOPSIS

p.rings.stats
p.rings.stats --help
p.rings.stats input=name [output=name] [radial_profile=string] [azimuth_profile=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

input=name [required]
Name of input raster map
output=name
Output azimuthal-mean raster (optional, fills each row with azimuthal mean)
radial_profile=string
Output text file: ring_radius mean_DN [km, DN]
azimuth_profile=string
Output text file: ring_lon mean_DN [deg, DN]

Table of contents

p.rings.stats - Radial statistics of ring brightness

DESCRIPTION

p.rings.stats computes radial statistics of ring brightness from a ring-plane projected raster (output of p.rings.project). Pixels are binned into annular rings of width bin_width (km) from rmin to rmax, and statistics (mean, median, standard deviation, min, max) are computed for each radial bin, optionally as a function of longitude.

Output: a CSV table and optionally a radial profile GRASS raster of ring brightness versus radius.

EXAMPLES

Compute a 5 km-wide radial brightness profile of the SOI B-ring:

p.rings.stats input=N1467344155_ringcyl \
    rmin=86250 rmax=86550 bin_width=5 \
    output=soi_bring_profile.csv radial=soi_bring_radial

Saturn ring imaging pipeline — Chain A (full context)

p.rings.stats is the final analysis step in Chain A (SOI B-ring, radlong + RingCylindrical pipeline). It consumes the output of p.rings.project. Full ready-to-run script: $HOME/RSDATA/cassini_soi_b_ring.sh.

# One-time: create an XY GRASS location for ring-plane coordinates
grass -c XY ~/grassdata/saturn_rings

# ── Step 1: SPICE kernels (p.spice.find) ──────────────────────────────────────
p.spice.find spacecraft=CASSINI time="2004-07-01T03:11:40" \
    dest=$HOME/RSDATA/Saturn/kernels

# ── Step 2: Raw image from OPUS (p.in.archive) ────────────────────────────
p.in.archive opus_id=co-iss-n1467344155 output=N1467344155_raw

# ── Step 3: Set radlong output region ────────────────────────────────────────
# north/south = ring_radius [km],  east/west = ring_longitude [deg]
g.region n=86550 s=86250 e=66.55 w=66.25 nsres=0.25 ewres=0.0003

# ── Step 4: Project raw image to ring-plane space (p.in.rings) ───────────────
KDIR="$HOME/RSDATA/Saturn/kernels"
p.in.rings \
    input=N1467344155_raw output=N1467344155_rings \
    time="2004-07-01T03:11:40" instrument=-82360 \
    spacecraft=CASSINI body=SATURN frame=IAU_SATURN \
    projection=radlong filter="CL1/CL2" \
    kernels="${KDIR}/lsk/naif0012.tls,${KDIR}/sclk/cas00172.tsc,\
${KDIR}/ik/cas_iss_v10.ti,${KDIR}/fk/cas_v40.tf,\
${KDIR}/pck/cpck_rock_21Jan2011_merged.tpc,${KDIR}/pck/pck00010.tpc,\
${KDIR}/spk/040701AP_SCPSE_04173_04236.bsp,\
${KDIR}/ck/04183_04185ra.bc"

# ── Step 5: RingCylindrical projection (p.rings.project) ─────────────────────
p.rings.project \
    input=N1467344155_rings output=N1467344155_ringcyl \
    center_radius=86400 center_lon=66.39
r.colors map=N1467344155_ringcyl color=grey

# ── Step 6: Radial statistics  ← this module ──────────────────────────────────
p.rings.stats input=N1467344155_ringcyl \
    rmin=86250 rmax=86550 bin_width=5 \
    output=soi_bring_profile.csv radial=soi_bring_radial

The CSV output columns are: r_km, mean, median, std, min, max (plus lon_deg when longitude binning is enabled). The optional radial raster soi_bring_radial is in the same DN units as the input map and can be displayed or analysed with standard GRASS raster tools.

NOTES

The input raster must be in ring-plane coordinates produced by p.rings.project (Chain A, radlong path). The polar output of p.in.rings (Chain B) is in km×km Cartesian space; to compute radial profiles from it, convert to ring_radius first with p.rings.project -i.

REFERENCES

SEE ALSO

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.rings.stats source code (history)

Accessed: Sunday Nov 15 11:06:06 2026


Main index | Paint index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual