LC(nged)

🎀 LC — the code-listing bestie (nged manual) 🎀

Okay so you're in nged and you need to know what codes your regions are actually rocking. That's what lc is for. It lives in the BRL-CAD User Commands manual and it's about to make your whole life easier, no cap.

✨ NAME ✨

lc — lists codes (i.e. region attributes) region_id, material_id, los, aircode, region name, region parent within a group or combination.

Like, it just lays them all out for you. Iconic behaviour honestly.

🌸 SYNOPSIS 🌸

lc [-d|-m|-s] [-r] [-z] [-0|-1|-2|-3|-4|-5] [-f {fileName}] {groupName}

🦋 DESCRIPTION 🦋

The lc command lists a set of codes (i.e. attributes) of regions within a group/combination. Listed in columns are the following: region_id, material_id, los, aircode, region name, region parent.

If a value is unset, it is reported as —. Yep, a little em dash. She's telling you "nothing here bestie" without saying a word. 💅

---

💖 OPTIONS 💖

• -d — Specifies to list only regions with shared region_id values. So, just the ones doubling up on an id. Duplicate alert 🚨
• -m — Specifies to list only regions with shared region_id values where one or more of the objects in the set of objects defined by shared region_id value reports a different material_id, aircode and/or los values. Essentially, this allows users to quickly find and resolve inconsistent codes (i.e, id settings) within a region_id group. This is the "wait, why do these two have different settings??" detector and it ate.
• -s — Specifies to list only one region with each combination of region_id, material_id, los, and aircode. One representative per combo, very demure, very minimal.
• -r — Remove regions from the list in which their parent is a region and the region is subtracted within the parent. The -r option can be combined with any other option. Very flexible, we love her 🫶
• -z — Specifies descending (z-a) sort order. Flipping the whole list around, main character energy.
• -0 -1 -2 -3 -4 -5 -6 — Specifies sort column 1, 2, 3, 4, 5, or 6 (referring to columns listed in the description of this command); 1 is default. If 0 is specified, the regions are listed in the order in which they are stored, but this will be overridden if -d, -m, or -s options are used, because of the sorting which needs to be done when either of those options is used. So like, -0 is "whatever order they're stored in" but the sorting trio said nope, we're sorting anyway. iykyk.
• -f FileName — Identifies output should be to a file and specifies the file name. If the path is not included as part of the FileName the path will be the current directory. Sending the whole thing to a file instead of your terminal — lowkey the move for big groups.

Heads up bestie: -0 gets overridden by -d, -m, or -s because of the sorting that needs to be done when either of those options is used. That's literally how it works, not me being dramatic. 💀

---

⭐ EXAMPLES ⭐

Example 1. Find regions that share a region id but disagree on other code settings.

mged>lc -m vehicle.c

Lists only the regions below vehicle.c that share a region id while disagreeing on material, LOS, or aircode values, which is useful before normalizing region attributes with edcodes.

So you run this first, see who's being inconsistent, then go fix it with edcodes. Chef's kiss workflow 👑

---

👑 AUTHOR 👑

BRL-CAD Team

💌 BUG REPORTS 💌

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org

---

Okay that's the whole page, you're so welcome 💜 This little cutie comes to you from BRL-CAD, filed under LC(nged) in the BRL-CAD User Commands manual — go forth and normalize those region attributes, bestie. 🌈✨🍓