The “Change Algo ID” window allows you to change the Algo ID of a Quagensia® Function.
You can view a Quagensia Function’s Algo ID in the “Algo ID” field located in the “Function Summary” section of all Quagensia Functions, and if you are allowed to edit a Quagensia Function you can open the “Change Algo ID” window from the “Change Algo ID” button to the right of the “Algo ID” field.
You should rarely need to change the Algo ID of a Quagensia Function. In fact, if you only ever create Quagensia Functions using buttons and menu items located within the Quagensia Desktop Application you should never need to use this feature.
However, if you copy and paste Quagensia Function files into your “My Algos” folder from outside of the Quagensia Desktop Application, for instance by copying and pasting files using Windows 10’s or Windows 11’s File Explorer, you may sometimes accidentally end up with two Quagensia Function files with the same Algo ID, which is not allowed.
Examples of scenarios where you could end up with two Quagensia Functions with the same Algo ID in your “My Algos” folder:
- You downloaded a Quagensia Function file from someone with whom you were collaborating, then downloaded a newer version of the file a week later, but instead of replacing the older version you copied the new version into your “My Algos” folder without removing the older version.
- In an attempt to create a different version of a Quagensia Function in your “My Algos” folder, you copied and pasted your Quagensia Function file from your “My Algos” folder back into your “My Algos” folder using Windows 10’s or Windows 11’s File Explorer and changed the new file’s name rather than accomplishing this task by using the “Copy Algo” button or menu item from within the Quagensia Desktop Application.
For your own safety, Quagensia will not allow you to generate the code for a Quagensia Strategy that uses a Quagensia Function whose Algo ID is not unique across all Quagensia Functions in your “My Algos” folder and your “Algos from Quagensia” folder, because the code generation engine won’t be able to determine with certainty which of the functions with the same Algo ID is the one that you intended for your Quagensia Strategy to call.
If you receive a Quagensia validation error that informs you of this problem, you can use the “Change Algo ID” window to change the Algo ID of one of the Quagensia Functions with the duplicate Algo IDs.
Note that if you change this Quagensia Function’s Algo ID, algos that reference this Quagensia Function will no longer be able to identify that it was this Quagensia Function that they were referencing, so this should only be done for newly created Quagensia Function files that were copied from outside of the application, and not for Quagensia Functions that other users are relying on.
Note also that changing a Quagensia Function’s Algo ID from the “Change Algo ID” window will save the Quagensia Function file’s unsaved changes permanently to disk in the same way that pressing the “Save” toolbar button or clicking on the main menu “Save” menu item does. Note also that the list of undo-able changes will be cleared, so all changes made to this Quagensia Function since the last time the Quagensia Function was loaded from disk won’t be able to be undone by pressing the “Undo” button.
If you have any doubts, create a backup of your Quagensia Function file first, then change the Algo ID to permanently change the Quagensia Function, permanently save the changes to disk, and lose the list of undo-able changes since the last time the Quagensia Function was loaded from disk.
