Data AcQuisition And Real-Time AnalysisScope - Spectrum - Spectrogram - Signal Generator
Software for Windows
Science with your Sound Card!
Contact us about
When this option is enabled, the default Save filename will have a 3-digit number appended to it which is incremented for each new Save. You can edit the default name (or the number) in the Save dialog, and subsequent Saves will be incremented from there.
For example, the initial Daqarta default Save filename is 'Data'. If you toggle Auto-Increment Filenames on before you save the first file, the default will show up as 'Data-000'. If that's not the name or value you want, you can edit it to something else... let's say 'BigTest-100'. That's the name that will be given to the file you are now saving. The next time you save a file, the default will be 'BigTest-101'.
Auto-Increment always uses three digits and always has a dash as a spacer. That helps to separate it from names that already end in a mumber; for example, 'Proj2020' would become 'Proj2020-000. When the incrementing portion reaches '-999' it stops incrementing. The next time you try to save a file, the default will be unchanged; if you accept it, you will be notified that the file already exists and asked if you want to overwrite it. That would be a good time to change to a different base name and start a new number series.
The same base name and incrementing number series are used for all data files of the same type, even if you choose a different extension. For example, if you save 'Data-000' as a .DQA file and then wish to also have a .TXT version of the same data, the default would nevertheless increment to 'Data-001' for the .TXT file. You might want to manually set that back to 'Data-000' so that you can tell that it is from the same raw data. Then when you subsequently go to save a new .DQA file, the default will be 'Data-001' as desired.
Note that Auto-Increment only applies to file Save, not Open.
Besides the Data files discussed above, separate base names and incrementing series are maintained for DDisk (.DQA, .WAV, and .DAT), MIDI Record (.MID), MIDI Setup (.DQM), and Juxt array (.JXT) files.
A separate increment system is used for Buf0-Buf7 Macro Array File Operations; see below.
AutoInc=1 turns this feature on.
AutoInc=0 turns it off.
AutoInc=x toggles to the opposite state.
When a macro Save command includes a default base file name, such as SaveDQA="MyFile", then the first time it runs with Auto-Increment active the default Save As name will be 'MyFile-000'. On the next run the default will be 'MyFile-001', and so on. If you run a macro with a different default name for the same type of Save (data, DDisk, MIDI, etc), such as SaveDQA="NewFile", the default count will reset to give 'NewFile-000', and continue from there. You can't alternate back and forth between these two macros and get a continuing series like 'MyFile-000', 'NewFile-000', 'MyFile-001', 'NewFile-001', etc.
If you have a Save command with a default base name and it is called repeatedly, such as via manual button clicks in a Custom Controls macro mini-app, or perhaps automatically in a timed repeating sequence, the Auto-Increment process still works as described above.
Note that if you exit the mini-app or timed macro and later re-start it, the increment series continues from where it left off. That's true even if you manually change the base name in the Save As dialog... the next start of the macro (assuming no other saves intervene) will have the new base name, not the one specified in the macro.
If instead you want each run to start with the base name as specified in the macro, with '-000' as the first increment, then you need to reset the Auto-Increment system via a command at the start of the macro. The command is specific to the type of Save:
AutoInc#Da=-1 ;Data (SaveDQA, SaveWAV, SaveDAT, SaveTXT) AutoInc#DD=-1 ;DDisk AutoInc#MI=-1 ;MIDIrec AutoInc#MS=-1 ;SaveDQM AutoInc#Jx=-1 ;SaveJXT AutoInc#Bu=-1 ;BufN array file saves
If you have different macros that use different base file names for the same type of save, such as SaveDQA="PhaseA" and SaveDQA="PhaseB", each one will automatically reset the Auto-Increment system for the new name, with '-000' as the first increment.
If you want to save 'PhaseA-000', 'PhaseB-000', 'PhaseA-001', 'PhaseB-001', etc, you can create a custom auto-increment system. The general idea is to use a fixed-point macro variable Var0-Z to hold the count, and increment it only once per set of saves. Note that the Var0-Z variables are preserved across Daqarta sessions, so your count can continue unbroken if desired.
Suppose you use VarR to hold the count. The actual code for a 'PhaseA-nnn' save would be something like:
SaveDQA="PhaseA-" + VarR(3.0)
This will save with a minimum of 3 integer digits and no decimal places. Values smaller than 999 will show leading zeros as needed. (Larger values will be shown properly... see "Decimal Display Format" under String Variables and Expressions.)
Macro Array File Operations such as Buf0="<SaveDQA" use a separate increment system. You must use AutoInc#Bu=1 just before the buffer file save to apply the auto-increment process. The state is automatically cleared after each save, so there is no need for AutoInc#Bu=0 (but it does no harm and can serve as a reminder in your code).
AutoInc#Bu=2 just before the buffer save will apply whatever state has been set via the main AutoInc, either using the macro commands above, or using the File Menu toggle.
Note that there is no AutoInc#Bu=x toggle. If you give such a command it will be interpreted as AutoInc#Bu=1.
Questions? Comments? Contact us!We respond to ALL inquiries, typically within 24 hrs.
Over 35 Years of Innovative Instrumentation
© Copyright 2007 - 2021 by Interstellar Research
All rights reserved