Exporting to Pyroleda

Overview

In order to make a firing script, you need to configure your show for your firing system from the "Show" menu in one of two ways: (1) You can specify your firing system ("Show > Set firing system") and then re-address the whole show ("Show > Re-address show") to have Finale add the required modules to each launch position and number them sequentially, or (2) you can specify what modules are at each launch position explicitly by editing the launch positions ("Show > Edit launch position" then "Edit modules"). For further instructions, please see the Export Overview section.

FSQ format

The FSQ format supports a single module with 25 pins, numbered 1-25. If you configure your show with "Show > Set firing system", no further configuration is required. If you add modules explicitly with "Show > Edit launch position", leave their module address field empty, set their first pin to 1, and set their number of pins to 25. Set the "matches per pin" field to the maximum number of effects you would like Finale to assign to a single pin, which could be anywhere from 1 (conservative) to dozens (aggressive) depending on your firing system hardware specifications and wiring choices.

FRC format

The FRC format supports five slats with addresses A-E, each with 10 pins, for a total of 50 pins. If you configure your show with "Show > Set firing system", no further configuration is required. If you add modules explicitly with "Show > Edit launch position", decide what slats will be at what launch positions, and add them as module/slats to the launch positions. Set their addresses to A-E; set their first pin to 1, and set their number of pins to 10. In Finale the pin numbers will appear as 1-10, though in the exported script the number 10 will be converted to 0, as the format requires. Set the "matches per pin" field to the maximum number of effects you would like Finale to assign to a single pin, which could be anywhere from 1 (conservative) to dozens (aggressive) depending on your firing system hardware specifications and wiring choices.

FBC, F3, and SQ3 formats

The FBC, F3, and SQ3 formats support 126 modules with addresses 1-126, each with 25 pins. If you configure your show with "Show > Set firing system", no further configuration is required. If you add modules explicitly with "Show > Edit launch position", decide what modules will be at what launch positions, and add them as module/slats to the launch positions. Set their addresses to 1-126; set their first pin to 1, and set their number of pins to 25. Set the "matches per pin" field to the maximum number of effects you would like Finale to assign to a single pin, which could be anywhere from 1 (conservative) to dozens (aggressive) depending on your firing system hardware specifications and wiring choices.

Exporting the script

Once you are ready to export your firing script, click one of the menu items "File > Export firing script > Pyroleda", choosing the menu item for the desired format.

Example

The following links are to an example file that you can see in Finale and the corresponding exported script files in the three Pyroleda formats, FSQ, FRC, FBC, F3, and SQ3. The example is based on four sequences of three shots separated by one second. The first six shots have a single effect per shot. The second six shots have two effects per shot.

FSQ format

The FSQ format is a simple format including only times times of each shot, in sequence. Finale will automatically separate shots that are closer together than .03 seconds to accommodate the electrical constraints of the firing system. In this example, shots are separated by one second or more, so the automatic separation is not required.

program
new
- 7.15
- 8.15
- 9.15
- 17.15
- 18.15
- 19.15
- 27.15
- 28.15
- 29.15
- 37.15
- 38.15
- 39.15
end
FRC format

The FRC format extends the FSQ format with a slat address. The example show file used to generate all these outputs specifies different module addresses and doesn't specify a slat address, so it generates an incorrect output in the FRC format, shown below. In the show file, all the shots are from the same module except the three shots at 17, 18 and 19 seconds, which are from a different module. Thus in the FRC format the shots at 7, 8, 9, 27, 28, 29, 37, 38, and 39 seconds correctly have pins 1-9 (and default slat address "a"), but the three shots at 17, 18, and 19 seconds independently have pins 1-3 and the same default slat address "a". If the example show file specified that those three shots were on slat "b" and the same module as the others, then those three rows in the output file would end in "b1" "b2" and "b3", which is correct.

In the FRC format, pin 10 is represented by the single digit 0. As with the FSQ format, Finale will automatically separate shots that are close together to accommodate the electrical constraints of the firing system, though the threshold for the FRC hardware is 1/10th of a second.

program
begin
- 00:07.1 a1
- 00:08.1 a2
- 00:09.1 a3
- 00:17.1 a1
- 00:18.1 a2
- 00:19.1 a3
- 00:27.1 a4
- 00:28.1 a5
- 00:29.1 a6
- 00:37.1 a7
- 00:38.1 a8
- 00:39.1 a9
end
FBC format

The FBC format supports different modules, and explicitly lists multiple effects attached to the same pin as multiple rows in the script. Thus in comparison to the FSQ and FRC formats, which only produce 12 rows for the 12 pins used in the show, the FBC format produces 18 rows, one for each effect. The second field in the row is the pin number, so you'll notice in rows 7-18 that there are two rows per pin, which accommodate the two effects attached to each of those pins.

The fields of the FBC format are MODULE, PIN, CUE_NUMBER, CUE_TIME, LAUNCH_POSITION, and EFFECT_NAME. The MODULE is the number of the module, 1-126, preceded by a colon. The PIN is a number in the range 1-25. The CUE_NUMBER begins at 1 and increments at each new firing time. The CUE_TIME is the shot time at which the pin is electrified. The LAUNCH_POSITION is the name of the launch position at which the shot occurs, or the name of the first launch position if effects at multiple launch positions are attached to the same pin with scab wire going from a mortar at one location to a module at another (you can do this in Finale by adding a module to both the launch position at which the module resides and the launch position of the effect to be fired). The EFFECT_NAME is the name of the effect, with spaces and special characters removed.

The FBC format firing system hardware has no electrical constraints requiring any separation of rapid shots.

Pyroleda FBC300 script

Created On: 
Time Format: 10MS

:10,1,1,7150,Position1,Red_Peony_3
:10,2,2,8150,Position1,Red_Peony_3
:10,3,3,9150,Position1,Red_Peony_3
:11,1,4,17150,Position2,Red_Peony_3
:11,2,5,18150,Position2,Red_Peony_3
:11,3,6,19150,Position2,Red_Peony_3
:10,4,7,27150,Position1,Red_Peony_3
:10,4,7,27150,Position1,Red_Peony_3
:10,5,8,28150,Position1,Red_Peony_3
:10,5,8,28150,Position1,Red_Peony_3
:10,6,9,29150,Position1,Red_Peony_3
:10,6,9,29150,Position1,Red_Peony_3
:10,7,10,37150,Position1,Blu_Peony_3
:10,7,10,37150,Position1,Red_Peony_3
:10,8,11,38150,Position1,Blu_Peony_3
:10,8,11,38150,Position1,Red_Peony_3
:10,9,12,39150,Position1,Blu_Peony_3
:10,9,12,39150,Position1,Red_Peony_3
F3 format

Like the FBC format, the F3 format supports different modules, and explicitly lists multiple effects attached to the same pin as multiple rows in the script. Thus in comparison to the FSQ and FRC formats, which only produce 12 rows for the 12 pins used in the show, the F3 format produces 18 rows, one for each effect. The sixth field in the row is the pin number, so you'll notice in rows 7-18 that there are two rows per pin, which accommodate the two effects attached to each of those pins.

The fields of the F3 format are CUE_NUMBER, CUE_TIME, TRIGGER_TYPE, GROUP, MODULE, PIN, and LAUNCH_POSITION_AND_EFFECT_NAME. The CUE_NUMBER, which is preceded by an "@" sign, begins at 1 and increments at each new firing time. The CUE_TIME is the shot time at which the pin is electrified. The TRIGGER_TYPE is always AUTO in scripts exported from Finale. You can change it manually to use other types of triggers. The GROUP number is from 1 to 5 inclusive, which you can set in Finale using the "TRK" field of the Firing View. The MODULE is the number of the module, 1-126. The PIN is a number in the range 1-25. The LAUNCH_POSITION_AND_EFFECT_NAME is a comment field combining the name of the launch position in parentheses with the name of the effect. Rows are sorted by firing time.

The F3 format firing system hardware has no electrical constraints requiring any separation of rapid shots.

Pyro III script generated by Finale

Created On: 
Time Format: 10MS

@1,7150,AUTO,1,10,1,(Position1) Red_Peony_3
@2,8150,AUTO,1,10,2,(Position1) Red_Peony_3
@3,9150,AUTO,1,10,3,(Position1) Red_Peony_3
@4,17150,AUTO,1,11,1,(Position2) Red_Peony_3
@5,18150,AUTO,1,11,2,(Position2) Red_Peony_3
@6,19150,AUTO,1,11,3,(Position2) Red_Peony_3
@7,27150,AUTO,1,10,4,(Position1) Red_Peony_3
@7,27150,AUTO,1,10,4,(Position1) Red_Peony_3
@8,28150,AUTO,1,10,5,(Position1) Red_Peony_3
@8,28150,AUTO,1,10,5,(Position1) Red_Peony_3
@9,29150,AUTO,1,10,6,(Position1) Red_Peony_3
@9,29150,AUTO,1,10,6,(Position1) Red_Peony_3
@10,37150,AUTO,1,10,7,(Position1) Blu_Peony_3
@10,37150,AUTO,1,10,7,(Position1) Red_Peony_3
@11,38150,AUTO,1,10,8,(Position1) Blu_Peony_3
@11,38150,AUTO,1,10,8,(Position1) Red_Peony_3
@12,39150,AUTO,1,10,9,(Position1) Blu_Peony_3
@12,39150,AUTO,1,10,9,(Position1) Red_Peony_3
@END

SQ3 format

The SQ3 script is used to program a specific module. Thus if a show has multiple SQ3 modules, each module will require its own script. When you export a SQ3 script, Finale writes multiple files, one file for each module. Finale adds a suffix to each filename to identify the module by number. For example, if you export an SQ3 script with the name "Test.csv" on a show that has two modules numbered 10 and 11, Finale will export two files, "Test-010.csv" and "Test-011.csv".

Since each SQ3 script programs one specific module, the rows in the script obviously do not need to specify a module. The fields in the SQ3 rows are, PIN, 0, HOURS, MINUTES, SECONDS, MILLISECONDS, all separated by semicolons. The PIN is a number in the range 1-25. The second field is hard-coded as zero. The time fields are all integers. Rows are sorted by firing time.

Unlike the FBC and F3 formats, the SQ3 format does not include the effect name in the rows. Thus a single row suffices per pin, even if multiple effects are ignited by that pin. The example above produces two SQ3 files "examplefile-sq3-010.csv" and "examplefile-sq3-011.csv", for the two modules, 10, and 11, respectively. The first file has 9 rows; the second file has 3 rows, for a total of 12 rows, one for each pin.

The F3 format firing system hardware has no electrical constraints requiring any separation of rapid shots.

Examplefile-sq3-010.csv (for module 10)

1;0;0;0;7;150
2;0;0;0;8;150
3;0;0;0;9;150
4;0;0;0;27;150
5;0;0;0;28;150
6;0;0;0;29;150
7;0;0;0;37;150
8;0;0;0;38;150
9;0;0;0;39;150

Examplefile-sq3-011.csv (for module 11)

1;0;0;0;17;150
2;0;0;0;18;150
3;0;0;0;19;150