MAKE_S1A_TOPS(1)

💖 NAME 💖

make_s1a_tops — ok so it's literally called make_s1a_tops, that's the whole name, we're keeping it simple bestie ✨

🌸 SYNOPSIS 🌸

<purple>yeah that's the whole vibe — six things in, no cap.</purple>

---

# 🦋 DESCRIPTION 🦋

<pink>Hiii so this program is part of **GMTSAR** 💅 and here's everything it wants from you:</pink>

- **`xml_file`** — the name of the xml file 🗂️
- **`tiff_file`** — the name of the tiff file 🖼️
- **`output`** — stem name of the output files `.PRM`, `.LED`, `.SLC` ✨
- **`mode`** — the mood, and the moods are:
  - `(0)` no SLC
  - `(1)` center SLC
  - `(2)` high SLCH and lowSLCL
  - `(3)` output ramp phase
- **`dr.grd`** — range shift table to be read in 📖
- **`da.grd`** — azimuth shift table to be read in 📖

---

## 🎀 Example 🎀

<purple>like, literally, here's what it looks like in the wild:</purple>

make_slc_s1a_tops s1a-s1-slc-vv-20140807.xml s1a-s1-slc-vv-20140807.tiff S1A20140807 1 dr.grd da.grd

<purple>and here's the shorter version, because the shift tables are optional, iykyk:</purple>

make_slc_s1a_tops s1a-s1-slc-vv-20140807.xml s1a-s1-slc-vv-20140807.tiff S1A20140807 1

---

## 👑 Output 👑

<pink>so depending on your mode, here's what falls out the other side:</pink>

- **mode 1:** `S1A20140807.PRM` `S1A20140807.LED` `S1A20140807.SLC`
- **mode 2:** `S1A20140807.PRM` `S1A20140807.LED` `S1A20140807.SLCH` `S1A20140807.SLCL` `S1A20140807.BB`

---

## 🫶 Note 🫶

<pink>ok this part MATTERS, bestie, listen up:</pink>

- if `dr` and `da` are not given, SLCs will be written with **no shifts**. 🫠
- `s1a-aux.xml` and `manifest.safe` (exclude the first line) should be concatenated to the `xml_file` for acquisitions acquired **before Mar 2015** (IPF version change).
- If not concatenated **or** IPF version is `2.43+`, elevation antenna pattern correction (EAP) will **not** be applied. 😭

> <red>fr fr do not skip the concatenation step unless you're okay with no EAP. that's the whole warning.</red>

---

## 🌈 Usage 🌈

and now, the plot twist: it just says all of it AGAIN. not me lying, it's right there in the source. so here it is, round two, in case you needed it twice (valid honestly):

• xml_file — the name of the xml file 🗂️
• tiff_file — the name of the tiff file 🖼️
• output — stem name of the output files .PRM, .LED, .SLC ✨
• mode — the mood, again:
  • (0) no SLC
  • (1) center SLC
  • (2) high SLCH and lowSLCL
  • (3) output ramp phase
• dr.grd — range shift table to be read in 📖
• da.grd — azimuth shift table to be read in 📖

🍓 Example (yes, again) 🍓

make_slc_s1a_tops s1a-s1-slc-vv-20140807.xml s1a-s1-slc-vv-20140807.tiff S1A20140807 1 dr.grd da.grd

make_slc_s1a_tops s1a-s1-slc-vv-20140807.xml s1a-s1-slc-vv-20140807.tiff S1A20140807 1

⭐ Output (yes, again) ⭐

• mode 1: S1A20140807.PRM S1A20140807.LED S1A20140807.SLC
• mode 2: S1A20140807.PRM S1A20140807.LED S1A20140807.SLCH S1A20140807.SLCL S1A20140807.BB

🧚 Note (yes, again) 🧚

• if dr and da are not given, SLCs will be written with no shifts.
• s1a-aux.xml and manifest.safe (exclude the first line) should be concatenated to the xml_file for acquisitions acquired before Mar 2015 (IPF version change).
• If not concatenated or IPF version is 2.43+, elevation antenna pattern correction (EAP) will not be applied.

still true the second time, still don't skip it 💀

and that's the page!! this one's filed under make_s1a_tops, dated May 2024, and yeah the manual section is User Commands — mwah, slay, go make some tops bestie 💅✨🦋