The ID Cards Manager in Phoranso provides a powerful and flexible interface for managing your Variable Star ID Cards. To access it, select ID Cards manager from the Variable ID Card menu. 


This section describes the purpose, features and usage of the ID Cards Manager, including how ID Cards are organized in Variable Star Databases (vSDbs) and how users can define a custom vSDb for targeted photometric analysis. Within the ID Cards Manager window, you gain extensive control over the active vSDb. It enables you to view and query the database, add, delete or modify ID Cards, and perform import and export operations. 

 


Concepts



Master Variable Star Database (Master vSDb)


ID Cards in Phoranso are organized into Variable Star Databases. The default vSDb is the Master database, which includes all ID Cards - both active and inactive - stored in your Documents > ID Cards folder. This Master vSDb is automatically loaded when Phoranso starts for the first time and serves as the default working dataset.


🞿 If you plan to work only with the Master database, you can skip the remainder of this section. If you're interested in defining and using custom vSDbs, read on.



Custom vSDbs


Users can define smaller, filtered working sets of ID Cards, called custom vSDbs. These can be created based on filters such as:


    • Proximity to a specific object (e.g., a custom vSDb with all variable stars near M42)
    • RA/DEC coordinate ranges
    • Magnitude or amplitude tresholds
    • Variability type or constellation


This modular approach allows for targeted photometric analysis and efficient data organization. In practice, during photometry, Phoranso uses the current vSDb to determine which variable stars are present in the field of view (FOV) of your Target star. It then photometrically processes only the corresponding ID Cards:


    • If the active vSDb is the Master, all available ID Cards are considered
    • If the active vSDb is a Custom subset, only the entries in that subset will be used for FOV star identification and photometry.



Identifying the active vSDb

The name of the currently active vSDb is always shown in the upper-left corner of the Phoranso main window. For example:


⏐Phoranso 1.1.0.0 (Phoranso Settings) - Variable Star Database: Master


The same label is also displayed at the top of the ID Cards Manager window, as shown in the example screenshot below:


⏐Variable Star Database: Master - Showing 2008 ID Cards

 



ID Cards Manager layout



Each ID Card (Target star) is represented by a dedicated row in the ID Cards Manager, with its contents intelligibly arranged across columns. The first column contains the name of the Target Star represented by the ID Card. Other columns display attributes such as RA/DEC, variability type, magnitude range, and associated Reference, Check and Comparison stars. 


Clicking on  a column title allows you to sort entries accordingly, and a subsequent click inversely sorts the data.


Double clicking on a row opens the ID Card of the selected Target star.


Navigate through the Variable Star Database using the vertical scroll bar or mouse wheel. 


In instances where an ID Card encompasses multiple Reference Stars or Comparison Stars, simply access the corresponding drop-down cell in the ID Cards Manager to choose the specific Reference or Comparison Star of interest.


Click on a row to select it. Use Shift + Click to select a range of adjacent rows, and use Ctrl + Click to select or deselect non-adjacent rows. 


You can also use your keyboard Arrow keys to move up/down across rows. Press Enter or double click to open the selected ID Card(s). Press Delete to remove selected ID Cards, subject to confirmation. Standard shortcuts like Ctrl + C (Copy) or Ctrl + V (Paste) are supported where applicable.


Click any field in the Comment column to enter or edit your comment text directly.


Right-clicking on a cell brings up a context menu that allows you to copy the cell's value to the Windows clipboard for use elsewhere.


At the top of the ID Cards Manager, are a series of menus allowing you to query and manipulate the contents of the Variable Star Database. We will explain each of them in the subsequent sections below.


File



The File menu provides options for managing Variable Star Databases (vSDbs) of ID Cards. It enables you to create, load, save and merge databases, etc.


New

Creates a new, empty vSDb. This is useful when you want to build a new working set of ID Cards from the ground up, by copying entries from another vSDb.


Open...

Opens an existing vSDb from disk. Use this option to continue working with a previously saved custom vSDb.


Open Master

Reloads the Master vSDb from your Documents > ID Cards folder. The Master database includes all ID Cards—both active and inactive. This menu option provides a convenient way to return to your full ID Card collection after working with a custom vSDb.


Save

Saves the currently open vSDb to its existing file. Use this to preserve changes (e.g., added or removed ID Cards, updated entries, status changes) without renaming the file.


Save As...

Saves the current vSDb to a new file. This is helpful when you want to preserve a snapshot of your current dataset (e.g., YoungStellarObjects_Near_M42).


Merge...

Combines another vSDb with the currently open one. Use this when you want to unify multiple custom vSDbs. For example, merging a set of Delta Scuti variable stars between RA 6h00m and 8h00m into your current vSDb. 


Import ID Cards

Two options exist to import ID Cards:


    • Importing a folder of ID Cards
      1. Choose the From folder sub-button
      2. A file selector window will open. Navigate to the folder containing the ID Cards and corresponding PNG images you want to import. 
      3. Select the desired ID Cards and click the Open button.
      4. After the import is complete, a confirmation dialog box will display the number of added ID Cards. Click OK to close the dialog.


    • Importing a zip file with ID Cards
      1. Choose the From zip file sub-button
      2. A file selector window will open. Navigate to the folder containing the zip file with ID Cards. 
      3. Select the zip file and click the Open button.
      4. After the import is complete, a confirmation dialog box will display the number of added ID Cards. Click OK to close the dialog.


Export ID Cards

Two options exist to export ID Cards:


    • Exporting ID Cards to a folder
      1. In the ID Cards Manager, select the ID Cards you want to export  
      2. Choose the To folder sub-button
      3. A folder selector window opens. Navigate to the folder to which you want to export the ID Cards. Click Select Folder when done.
      4. After the export is complete, a confirmation dialog box appears. Click OK to close the dialog.


    • Exporting ID Cards to a zip file
      1. In the ID Cards Manager, select the ID Cards you want to export
      2. Choose the To zip file sub-button
      3. A folder selector window opens. Navigate to the folder in which you want to store the zip file with ID Cards. Click Select Folder when done.
      4. After the export is complete, a confirmation dialog box appears. Click OK to close the dialog.
      5. The selected folder will now contain a zip file PhoransoIDCards.zip with the exported ID Cards


Recent databases

Displays a list of recently opened vSDbs for quick access. Selecting an item from this list opens it immediately.


Exit

Closes the ID Cards Manager



Edit ID Cards



The Edit menu provides options to view, modify and manage the contents of ID Cards in your currently active vSDb. These operations include copying and pasting ID Cards or individual components, displaying detail views, deleting entries, and managing activations status, and AUIDs. 


  • Copy

Use the Copy submenu to copy all or part of the selected ID Card(s) to the Phoranso internal clipboard. This is useful when you want to duplicate content between databases or store information temporarily.


    • ID Card

Copies the entire selected ID Card(s) to the Phoranso clipboard. You can then paste the ID Cards into a new or existing vSDb.


    • Ref Stars
      • Selected: Copies only the currently selected Reference Star within the ID Card, to the clipboard.
      • All: Copies all Reference Stars defined in the ID Card, to the clipboard.


    • Check Star

Copies the Check Star to the clipboard


    • Comp Stars
      • Selected: Copies only the currently selected Comparison Star.
      • All: Copies all Comparison Stars listed in the ID Card.


    • Comment

Copies the comment section of the ID Card, to the clipboard.



  • Paste

Use the Paste submenu to insert data previously copied to the Phoranso internal clipboard into the corresponding components of the selected ID Card(s). The menu structure mirros that of the Copy command:


    • ID Card

Pastes one or more complete ID Card(s) from the Phoranso clipboard into the currently selected vSDb. If an ID Card with the same target name already exists, it will not be pasted.


    • Ref Stars
      • Add clipboard Ref Stars: Adds the clipboard's Reference Star(s) to the Ref Stars of the selected ID Card.
      • Replace with clipboard Ref Stars: replaces all Reference Stars of the selected ID Card, with the ones from the clipboard.


    • Check Star

Pastes the Check Star into the currently selected ID Card, replacing any existing Check Star.


    • Comp Stars
      • Add clipboard Comp Stars: Adds the clipboard's Comparison Star(s) to the Comp Stars of the selected ID Card.
      • Replace with clipboard Comp Stars: replaces all Comparison Stars of the selected ID Card, with the ones from the clipboard.


    • Comment

Pastes a comment into the Comment field of the currently selected ID Card(s), replacing any existing comment.



  • Show

The Show menu provides quick access to detailed information for any selected ID Card. It includes the following two options:


    • ID Card

Opens the full ID Card of the selected target star in a separate window. This view displays all details associated with the star, including position, variability type, magnitude range, and associated reference, comparison, and check stars. 


    • ID Card Image

Displays the image associated with the selected ID Card, if available. This image may be an AAVSO finder chart or a field reference image used during photometric analysis. Viewing the image helps visually verify star identification and reference star positioning.



  • Delete

The Delete menu allows you to remove specific components or entire ID Cards from your Variable Star Database. Use these options carefully, as deletions are irreversible.


    • Complete ID Card

Deletes the entire selected ID Card(s) from the database


    • ID Card Image

Removes the image linked to the currently selected ID Card(s) without deleting the ID Card itself.


    • Ref Stars
      • Selected: Deletes only the currently selected Reference Star within the active ID Card.
      • All: Deletes all Reference Stars associated with the active ID Card.


    • Check Star

Deletes the Check Star entry of the selected ID Card.


    • Comp Stars
      • Selected: Deletes only the currently selected Comparison Star within the active ID Card.
      • All: Deletes all Comparison Stars associated with the active ID Card.


    • Comment

Deletes the comment attached to the selected ID Card.


🞿 Important: Before deleting, ensure you have selected the correct ID Card or component. Deletion actions cannot be undone.



  • Comment

The Comment menu allows you to add new notes or expand existing ones for selected ID Cards. Comments can be used to record relevant meta data about an ID Card.


    • Add Comment...

Opens a dialog where you can enter a new comment for the selected ID Card(s). If a comment already exists, it will be replaced.


    • Append To Comment...

Allows you to add text to the end of an existing comment without removing or overwriting the current content. 



  • AUID

The AAVSO AUID (AAVSO Unique IDentifier) is a unique identifier assigned by the AAVSO to individual variable stars. This identifier is used to uniquely and unambiguously identify a particular star in the AAVSO VSX database.


When submitting a report with photometric observations to the AAVSO International Database it is important that each variable star in the report has been assigned a unique AAVSO AUID. Phoranso can assist you in obtaining AUIDs for target stars (ID Cards) with a missing AUID.


    • Update AUIDs...

This operation checks whether an AUID already exists for each selected star by querying the AAVSO VSX database. If an AUID is found, it is added to the star's AUID column in the ID Cards manager. If not, the field remains blank.

Note: this action does not generate new AUIDs - it only retrieves existing ones. To request new AUIDs for stars without one, use the Request AUIDs option. 


    • Request AUIDs...

To request AUIDs for stars lacking one, first log in to your AAVSO account (refer to the AAVSO website for information on obtaining a login code). After logging in, select the stars in the ID Cards Manager and choose Request AUIDs.


Phoranso will then initiate a request to the AAVSO VSX database to allocate an AUID for the stars. These requests are facilitated through your web browser, creating a new browser tab for each requested AUID. Check your browser for completion status. If AUID assignment is successful, the ID Cards Manager will reflect the AUID information for the affected stars.


  • Activate ID Cards

ID Cards can be active or inactive. Marking an ID Card as inactive means it will remain in the Variable Star Database but will be excluded from photometry calculations. You have the flexibility to reactivate an inactive ID Card at any time.


Use the Activate ID Cards operation to set the status of the selected ID Cards to active.


  • Deactivate ID Cards

Use the Deactivate operation to set the status of the selected ID Cards to inactive. 




Filter ID Cards



The Filter ID Cards menu provides powerful filters to narrow down the contents of your current Variable Star Database (vSDb) by applying one or more selection criteria. 


🞿 These filters are non-destructive—only affecting what is displayed in the ID Cards Manager without modifying the underlying data. Filters can be combined and cleared at any time.


  • In Field of View...

Allows to display only those ID Cards that fit within a specified Field of View (FOV). The FOV box is defined by its center position, width, height and roll-angle. ID Cards with coordinates within the defined FOV box will be displayed in the ID Cards Manager, offering a convenient method for inspecting groups of ID Cards within a designated FOV.


You can provide the FOV center position by:

    • Entering a valid AAVSO VSX star name
    • Entering a valid SIMBAD star name 
    • Specifying the center coordinates using Right Ascension (RA) and Declination (Decl) values separated by a semi-colom (;). For RA and Decl values, they must be in sexagesimal format with values separated by spaces. For example: a valid entry could be: 04 59 13.57; -69 35 43.3. Alternatively, the values can be expressed in degrees. Example: 74.80654; -69.595361.


  • Near Deep Sky Object...

Filters the vSDb to show only ID Cards  that fit within a specified Field of View (FOV). The FOV box is defined by a named deep sky object (e.g., “M42” or “NGC 7000”), a width, height and roll-angle.


  • By Magnitude...

Retains only ID Cards with stars brighter or fainter than a specified magnitude threshold.


  • By Amplitude...

Filters the ID Cards based on the amplitude of variability, keeping only those with an amplitude smaller or larger than a specified treshold.


  • By Variability Type...

Displays only those ID Cards whose variability type matches a given type (e.g., “EA”, “RR”, “DSCT”).

Select the type from the pop-up box.


  • By Constellation...

Filters the list to show only ID Cards that belong to a selected constellation.


  • By Comment...

Displays only ID Cards that contain specific text in the comment field. Useful for retrieving stars annotated during earlier analysis.


  • Active Only

Shows only the ID Cards marked as Active. 


  • Inactive Only

Displays only the Inactive ID Cards, allowing you to review or reactivate stars previously excluded from your working dataset.


  • Column Filtering

This option determines whether the Status, Type and Comment columns support interactive filtering through their column headers:


    • Enable

Enables Column Filtering for the supported columns. A small red square appears in the header of each filterable column, indicating that a filter can be applied. Click this red marker to define your filter. 


    • Disable

Turns off Column Filtering, removing the red square indicators, without altering the vSDb 


  • Clear All Filters

Removes all currently active filters—whether applied via this menu or via Column Filtering—and restores full visibility of the current vSDb content.




Sort ID Cards



The Sort ID Cards menu allows to arrange ID Cards in the ID Cards Manager based on their proximity to a designated position. The Sort by distance from option displays the Enter position dialog box, enabling you to input the starting Position for sorting. ID Cards will then be arranged in the ID Cards Manager, with objects closest to the specified location appearing at the top of the window, in decreasing order of proximity.


You can provide the Location position by:

  • Entering a valid AAVSO VSX star name
  • Entering a valid SIMBAD star name 
  • Specifying the location coordinates using Right Ascension (RA) and Declination (Decl) values separated by a semi-colom (;). For RA and Decl values, they must be in sexagesimal format with values separated by spaces. For example: a valid entry could be: 04 59 13.57; -69 35 43.3. Alternatively, the values can be expressed in degrees. Example: 74.80654; -69.595361.




Find Target star



This feature allows you to quickly locate and focus on a specific Target star within the ID Cards Manager. To use it, type the name of the Target star into the text field following the Find Target star label, then press Enter. The ID Cards Manager will automatically refresh and scroll to position the matching ID Card at the top of the table, making it immediately visible and ready for further inspection.


This is particularly useful when working with large vSDbs, where manually browing for a specific star would be inefficient.