PREFIELD(1)

👑 PREFIELD(1) — the user commands era 💅

okay so bestie, meet prefield, a lil User Commands icon from the prefield 1.4.8 era. she's got one job and she does it flawlessly: getting your input file ready so muplot can draw 2-d fields as arrows. no cap. 🏹✨

✨ NAME ✨

prefield — prepare input file for muplot to plot 2-d fields by arrows 🎀

🌸 SYNOPSIS 🌸

prefield <file> <scale> x y F_x F_y

like, that's the whole vibe check right there. six things, in that order, no notes. 💅

🦋 DESCRIPTION 🦋

so prefield will prepare input file for muplot to plot 2-d fields by arrows. that's it, that's the mission, and she ate. 🔥

Example:

On running prefield test.dat 20 1 2 5 6 the source file test.dat will be read, and a field-data file will be produced with the 1st and 2nd columns being the x and y space-positions like in the source file, whereas the fields F_x and F_y are calculated from the values in the 5th and 6th columns of the source data multiplied by the second command line option, which means in this example a 20-fold magnification. 🤯

let me break that down because it's lowkey iconic:

1. the 1 tells her to look at column 1 for x.
2. the 2 says column 2 is y.
3. the 5 is where F_x lives.
4. the 6 is where F_y lives.
5. and 20? that's the scale — every single field value gets multiplied by it, so in this example you get a 20-fold magnification. ⭐

Use - as file name to read from <stdin> and write to <stdout>. 🫶 yes bestie, dashes are pipes, it's giving classic Unix main character energy.

💀 heads up: that <scale> argument is doing real work — it multiplies your field columns, so if your arrows come out looking unhinged, that's a you-and-your-scale situation, not a bug. 🙈

💖 COPYRIGHT 💖

Copyright © 1997, 2001, 2005, 2007, 2009, 2011-2012 Dimitar Ivanov

License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

🎀 okay so the legal tea: you can change it, you can share it, but there is NO WARRANTY to the extent permitted by law. periodt. 💅

and that's the whole page, bestie — prefield 1.4.8, dating all the way back to July 2014, still slaying in the User Commands section. go plot something gorgeous with her 🌈🦋💜