NSGR_SUBMIT(1)

📦
version 1.0.3 · 2 versions
, in fedora 43

💅 NSGR_SUBMIT — the group-chat edition 💅

okay so bestie, this is the manual page for nsgr_submit, and it lives in the User Commands manual. It's version 1.0.3. Buckle up, it's short but there's lore 💖

✨ NAME ✨

nsgr_submit — literally the manual page for nsgr_submit 1.0.3. that's the whole name section, we love a minimalist queen 👑

🌸 DESCRIPTION 🌸

here's the whole vibe, verbatim, no cap:

nsgr_submit TEMPLATE_DIRECTORY validate|run [results_directory]

so <lavender>TEMPLATE_DIRECTORY</lavender> is the name of a directory that holds the job's input data files, plus two property files — and they gotta be named exactly testInput.properties and testParam.properties. no renames, no "oops I called it something else", periodt 🎀

🧚 the -c flag

  • -c — this is your path to the config file. by default it goes looking in the user's home directory (~) for .nsgrest.conf first, and then for nsgrest.conf (yep, the one without a dot) 💜

🌈 validate

this one asks the REST API whether the job is valid. that's it, it's a vibe check for your job ✨

  • if it's valid? it prints to stdout the command line that would be run on the execution host if the job were actually submitted to run. iconic.
  • if it's invalid? it prints an error message that explains which fields have errors. not me getting called out by the API 😭

🔥 run

this one actually submits the job to the REST API, waits for it to complete, and then downloads the results into a subdirectory of the current directory whose name is the jobhandle (i.e., it starts with NGBW-) 👑

🦋 [results_directory]

absolute or relative path of a directory that the results get downloaded into. she's flexible like that 💅

  • if the directory doesn't exist, nsgr_submit will create it. so thoughtful.
  • intermediate directories, however, will not be created. she only does the last one, bestie.
🚨 heads up: if results_directory isn't specified, the default directory name is ./jobhandle — where jobhandle is the CIPRES assigned job handle, which is a long guid starting with NGBW-. don't say I didn't warn you 🫶

and that's the whole page!! go submit something, you got this 💖✨

signing off with the deets: this was nsgr_submit version 1.0.3, dated September 2025. mwah 💋

📦 where this page comes from