Re: [Users] Users Digest, Vol 184, Issue 14

Dear Iosif,

Yes, @ALLOCATION@ will be read from the corresponding * .ini file if not specified with the --allocation=YOUR_ALLOCATION command line option. And yes the command line will override the information in the .ini file.

However, I would rather place the allocation information in simfactory/etc/defs.local.ini than in the <machine>.ini file. Multiple users with different allocations can use the same machine, so that information belongs in the user specific .ini file.

There is no list of macros documented anywhere, unfortunately.

Cheers,

Peter

Assistant Professor Research Center for Computation & Technology and Department of Physics & Astronomy Louisiana State University

On Sat, 2 Aug 2025, IOSIF PANAGIOTIS wrote:

Dear Leo,

Thank you for your answer and for sharing your experience. No, I hadn't received a reply to my question yet.

So it seems that macros such as @ALLOCATION@ (or any other SimFactory placeholder) can be changed via :

• either editing the <machine>.ini file
• or specifying the relevant command line option (i.e., among the ones that come up when doing "./simfactory/bin/sim --help").

And if I understand correctly, it seems that whatever is specified as a command-line option for sim takes priority over what is specified in the configuration files. Is this correct?

If yes, then these placeholders could be simply left alone when editing the submitscript and runscript, and set via the respective sim command-line option when submitting a simulation. Right?

And to reiterate part of my initial question:

• If these @FOO@ macros for SimFactory are documented somewhere, I would be grateful if you could point me to the relevant page.
• If such documentation does not exist, then it is also ok, and this empirical understanding will have to suffice for now. I was just asking to make sure I was not missing some obvious documentation source.

Best, Panayotis

---

From: Users users-bounces@einsteintoolkit.org on behalf of Leonardo Werneck wernecklr@gmail.com Sent: Thursday, July 31, 2025 7:26 PM To: users@einsteintoolkit.org users@einsteintoolkit.org Subject: Re: [Users] Users Digest, Vol 184, Issue 14   Dear Iosif,

I hope this message finds you well.

I'm not sure you already got a reply, but in case you haven't, my understanding is that placeholders like @FOO@ are there to indicate things you need to change yourself, manually.

So when you see something like:

#SBATCH -A @ALLOCATION@

then it means you should replace @ALLOCATION@ with the name of your allocation in the specific cluster.

Someone else can correct me if this is not correct, but that's how I usually handle these.

Cheers, Leo

On Fri, Jul 25, 2025 at 8:06 AM users-request@einsteintoolkit.org wrote: Send Users mailing list submissions to         users@einsteintoolkit.org

  To subscribe or unsubscribe via the World Wide Web, visit
          http://lists.einsteintoolkit.org/mailman/listinfo/users
  or, via email, send a message with subject or body 'help' to
          users-request@einsteintoolkit.org

  You can reach the person managing the list at
          users-owner@einsteintoolkit.org

  When replying, please edit your Subject line so it is more
  specific
  than "Re: Contents of Users digest..."


  Today's Topics:

     1. SimFactory placeholder macros (IOSIF PANAGIOTIS)
     2. Issue with ReadInterpolate (Luciano Combi)


  ----------------------------------------------------------------------

  Message: 1
  Date: Fri, 25 Jul 2025 10:43:36 +0000
  From: IOSIF PANAGIOTIS <PANAGIOTIS.IOSIF@units.it>
  To: Einstein Toolkit Users <users@einsteintoolkit.org>
  Subject: [Users] SimFactory placeholder macros
  Message-ID:
         <AS8P250MB08637A69A316C8763E533B5FF959A@AS8P250MB0863.EURP250.PROD.OUTLOOK.
  COM>

  Content-Type: text/plain; charset="iso-8859-1"

  Hi,

  I have been following this document,
  https://einsteintoolkit.org/seminars/2022_02_24/index.html , to
  set up ET on my cluster, working also on some example
  configuration files.

  While preparing the submit and run scripts, I wanted to check
  the description of the @FOO@ macros that SimFactory uses.

  I checked these places but found no information.

    *
  https://simfactory.bitbucket.io/simfactory2/userguide/ (no
  mention of macros)
    *

https://docs.einsteintoolkit.org/et-docs/Simulation_Factory_Advanced_Tutori al (1 mention of the @USER@ macro and a pointer to a section#Macros<https://docs.einsteintoolkit.org/et-docs/Simulation_Factory_Advance d_Tutorial#Macros> that seems missing)   * https://docs.einsteintoolkit.org/et-docs/Configuring_a_new_machine (there is no information on the submitscript and runscript)

  So I would like to ask:

  If e.g. I have this line in my submitscript:
  #SBATCH -A @ALLOCATION@

  Where is @ALLOCATION@ "read" from?

  My guess is that this is specified in the .ini file in this
  line:
  allocation = <project_account>

  Could you confirm if this is the case?

  Is there another source of documentation (that I might have
  missed) describing what these @FOO@ placeholders do?

  Best regards,
  Panagiotis


  -------------------
  Panagiotis Iosif
  postdoctoral researcher
  Department of Physics, University of Trieste
  Via Alfonso Valerio 2, Trieste 34127
  Italy
  -------------------