How do I get GCG graphics on my Mac?

Some GCG programs such as mapplot, dotplot, plotfold, pepplot, pileup can produce graphic output. If your Mac can display graphics (i.e. has suitable graphic display software such as Versaterm Pro or an X-terminal emulator) you can have the graphic output displayed directly on your machine. Read on for instructions. If your Mac does not do Tektronix or X-term emulation, you can get the graphics output into a file which you can then print. See What if my connection software can't do graphics for instructions.

If your connection software does Tektronix or Xterm emulation:
These graphics are not publication quality, but may be useful for quick checks of the output. (For publication-quality graphics, you can send the output to a plotter/printer directly. For example, see How do I print GCG graphics to my postscript printer.)

First you need to tell GCG what kind of graphics to send. After you start up GCG (by typing 'gcg' at the helix prompt) type 'setplot', then select the 'mactek' option if you have Versaterm Pro, and 'colorX' or 'monoX' if you have an X-windows emulator.

Then type 'plottest', and a Versaterm window should appear showing test graphics. This means that GCG is able to display correctly to your machine.

If you now run any GCG program that produces graphics, it will send the output to this window.

Here is a sample session:
helix% setplot
+---------------------->  displaying all of 7 option(s)  <---------------------+
|mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen            |      
|pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]                   |
|colorX     Color X Windows Graphics Window                                    |
|monoX      Monochrome X Windows Graphics Window                               |
|lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps   |
|EPSF       to generate encapsulated popostscript file ->gcgplot.epsf          |
|HP7550     to select a HP7550 plotter file ->gcgplot.gl                       |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
+------------------------------------------------------------------------------+
Enter a command. Choices are:
          <up-arrow> and <down-arrow> scroll the list
          <return> makes GCG use the selected device
          Q quits without doing anything

          C creates and edits a new device
          (you can't delete from the site file)
          V views the selection (use C to edit a copy)

Done

 
 Plotting Configuration set to: 
 
       Language: tekd 
         Device: VERSATERM-TEK4105
  Port or Queue: term
 
helix% plottest
PlotTest plots a test pattern to see if your plotter is configured
properly.  The test pattern uses every GCG graphics feature.  It should
resemble the example test pattern in the PROGRAM MANUAL. 

  Process set to plot with VERSATERM-TEK4105 attached to term
  using the tekd graphic interface.

 tekd instructions for a VERSATERM-TEK4105 are now being sent to term.

Press <Return>

helix% mapplot

MapPlot displays restriction sites graphically.  If you don't have a
plotter, MapPlot can write a text file that approximates the graph. 

  Process set to plot with VERSATERM-TEK4105 attached to term
  using the tekd graphic interface.

 (Linear) MAPPLOT  of what sequence ?  x87617.gb_new

                  Begin (* 1 *) ?  
                End (*  1497 *) ?  

 ***  I read your enzyme data file "enzyme.dat"!!  *** 

 Select the enzymes:  Type nothing or "*" to get all enzymes. Type "?"
 for help on which enzymes are available and how to select them. 

                                       Enzyme(* * *):  

 tekd instructions for a VERSATERM-TEK4105 are now being sent to term.

Press <Return>

helix%
Sample pepplot graphic output

The graphics file can be printed (in Versaterm Pro, use the Print Graphics option under the File menu) or saved (using the Save Graphics option under the File menu). If saved as a Pict file, the graphics can be imported into other Mac programs. The file is a bitmap file, and cannot be easily modified, but simple additions such as arrows can be made. If you want publication-quality graphics, see How can I modify a GCG graphics figure for publication?


How do I get GCG graphics on my PC (clone)?

If your PC can display graphics (i.e. has suitable graphic display software such as SmarTerm or an X-terminal emulator) you can have the graphic output displayed directly on your machine. Read on for instructions. If your PC does not do Tektronix or X-term emulation, you can get the graphics output into a file which you can then print. See What if my connection software can't do graphics for instructions.

If your connection software does Tektronix or Xterm emulation:
These graphics are not publication quality, but may be useful for quick checks of the output. (For publication-quality graphics, you can send the output to a plotter/printer directly. For example, see How do I print GCG graphics

First you need to tell GCG what kind of graphics to send. After you start up GCG (by typing 'gcg' at the helix prompt) type 'setplot', then select 'pctek' if you have SmarTerm, and 'colorX' or 'monoX' if you have an X-windows emulator. You should see a window appear on your screen.

Then type 'plottest', and you should see graphics appear in the window. This means that GCG is able to display correctly to your machine.
If you now run any GCG program that produces graphics, it will send the output to this window.

If you are using some other communications software, the important question is whether it can do Tektronix emulation. Try the 'pctek' option in setplot, if that doesn't work look through the software user manual and see if it says anything about emulating Tektronix. If not, you may be out of luck; if you really need the graphics you will either have to get the GCG graphics to go to a file and print that, or buy different communications software.

Sample session:
helix% setplot
+---------------------->  displaying all of 7 option(s)  <---------------------+|
|mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen             |      
|pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]                |              |
|colorX     Color X Windows Graphics Window                                    |
|monoX      Monochrome X Windows Graphics Window                               |
|lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps   |
|EPSF       to generate encapsulated popostscript file ->gcgplot.epsf          |
|HP7550     to select a HP7550 plotter file ->gcgplot.gl                       |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
+------------------------------------------------------------------------------+

Enter a command. Choices are:
          <up-arrow> and <down-arrow> scroll the list
          <return> makes GCG use the selected device
          Q quits without doing anything

          C creates and edits a new device
          (you can't delete from the site file)
          V views the selection (use C to edit a copy)

Done

 
 Plotting Configuration set to: 
 
       Language: tekd 
         Device: TEK4014
  Port or Queue: term
 
helix% plottest
PlotTest plots a test pattern to see if your plotter is configured
properly.  The test pattern uses every GCG graphics feature.  It should
resemble the example test pattern in the PROGRAM MANUAL. 

  Process set to plot with TEK4014 attached to term
  using the tekd graphic interface.

 tekd instructions for a TEK4014 are now being sent to term.

Press <Return>

helix% mapplot

MapPlot displays restriction sites graphically.  If you don't have a
plotter, MapPlot can write a text file that approximates the graph. 

  Process set to plot with TEK4014 attached to term
  using the tekd graphic interface.

 (Linear) MAPPLOT  of what sequence ?  x87617.gb_new

                  Begin (* 1 *) ?  
                End (*  1497 *) ?  

 ***  I read your enzyme data file "enzyme.dat"!!  *** 

 Select the enzymes:  Type nothing or "*" to get all enzymes. Type "?"
 for help on which enzymes are available and how to select them. 

                                       Enzyme(* * *):  

 tekd instructions for a TEK4014 are now being sent to term.

Press <Return>

helix%
Sample pepplot graphic output

If you want publication-quality graphics, see How can I modify a GCG graphics figure for publication?.


How do I get GCG graphics on my Unix workstation?

Your workstation most likely has X-terminal software already installed, which can comfortably handle GCG graphics. You can choose between color and mono (black-and-white) graphics, depending on your machine. Set up GCG graphics with 'setplot'. You should see a new blank window pop up on your screen. Then try 'plottest' to make sure everything is working correctly -- graphics should appear in the window. Don't click on 'exit' in the graphics window. In your main window (the one that is connected to helix) run a GCG graphics program. The output should appear in the graphics window.

Sample session:
helix% setplot
+---------------------->  displaying all of 7 option(s)  <---------------------+
|mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen             |
|pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]                   |
|colorX     Color X Windows Graphics Window                                    |
|monoX      Monochrome X Windows Graphics Window                               |
|lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps   |
|EPSF       to generate encapsulated popostscript file ->gcgplot.epsf          |
|HP7550     to select a HP7550 plotter file ->gcgplot.gl                       |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
|                                                                              |
+------------------------------------------------------------------------------+Enter a command. Choices are:
          <up-arrow> and <down-arrow> scroll the list
          <return> makes GCG use the selected device
          Q quits without doing anything

          C creates and edits a new device
          (you can't delete from the site file)
          V views the selection (use C to edit a copy)

Done

 
 Plotting Configuration set to: 
 
       Language: xwindows 
         Device: COLORWORKSTATION
  Port or Queue: GCG_Graphics

helix% plottest

PlotTest plots a test pattern to see if your plotter is configured
properly.  The test pattern uses every GCG graphics feature.  It should
resemble the example test pattern in the PROGRAM MANUAL. 

  Process set to plot with COLORWORKSTATION attached to GCG_Graphics
  using the xwindows graphic interface.

 xwindows instructions for a COLORWORKSTATION are now being sent to GCG_Graphics.

 Interactive Plotter

Press 


 PLOTTEST normal exit
Graphics window after plottest
108% mapplot

MapPlot displays restriction sites graphically.  If you don't have a
plotter, MapPlot can write a text file that approximates the graph. 

  Process set to plot with COLORWORKSTATION attached to GCG_Graphics
  using the xwindows graphic interface.

 (Linear) MAPPLOT  of what sequence ?  x87617.gb_new

                  Begin (* 1 *) ?  
                End (*  1497 *) ?  

 ***  I read your enzyme data file "enzyme.dat"!!  *** 

 Select the enzymes:  Type nothing or "*" to get all enzymes. Type "?"
 for help on which enzymes are available and how to select them. 

                                       Enzyme(* * *):  

 xwindows instructions for a COLORWORKSTATION are now being sent to GCG_Graphics.

Press <Return>


Press <Return>


Press <Return>
helix%
Graphics window after mapplot


How do I get graphics on my Windows NT machine?

The default communications software that comes with NT machines is limited to text display. Possible options are:
  • Save the output as a postscript file (see What if my terminal software can't do graphics?).
  • Print this file (see the section on Printing)
  • Alternatively, view the file using some display program like Ghostscript. A free version of Ghostscript for Windows NT is available at http://www.cs.wisc.edu/%7Eghost/.

    We are looking into X-terminal emulators for NT machines, and information about those configurations will be added here when available.


    What if my connection software can't do graphics?

    Some terminal emulation software doesn't permit graphics output, or doesn't do a very good job. One example is a Mac running NCSA Telnet, which may produce poor-quality graphics that doesn't allow you to read the text or interpret the graphics. Other workstation/software configurations, while producing somewhat better graphics, are still not good enough for publication or for detailed examination of the output. You have a couple of options:

    1. Avoid terminal graphics, and go directly to a plotter or printer. If you have a printer capable of postscript output, eps output, or plotter that accepts HP7550 plotter output, you can have the graphics output sent to a file, and then print that file. To do this, choose 'lwpost', 'EPSF' or 'HP7550' as the setplot option (depending on what kind of plotter/printer you have). After the program is run and has produced the output file, transfer that file to your computer and print it.

    Note that the graphic output file will be overwritten each time you run a graphic output program. If you want to save the plot, rename the file!.

    Sample session:
    helix% setplot
    +---------------------->  displaying all of 7 option(s)  <---------------------+
    |mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen             |
    |pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]                   |
    |colorX     Color X Windows Graphics Window                                    |
    |monoX      Monochrome X Windows Graphics Window                               |
    |lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps   |
    |EPSF       to generate encapsulated popostscript file ->gcgplot.epsf          |
    |HP7550     to select a HP7550 plotter file ->gcgplot.gl                       |
    |                                                                              |
    |                                                                              |
    |                                                                              |
    |                                                                              |
    |                                                                              |
    +------------------------------------------------------------------------------+
    Enter a command. Choices are:
              <up-arrow> and <down-arrow> scroll the list
              <return> makes GCG use the selected device
              Q quits without doing anything
    
              C creates and edits a new device
              (you can't delete from the site file)
              V views the selection (use C to edit a copy)
    
    Done
    
     
     Plotting Configuration set to: 
     
           Language: psd 
             Device: LASERWRITER
      Port or Queue: gcgplot.ps
     
    helix% mapplot
    
    MapPlot displays restriction sites graphically.  If you don't have a
    plotter, MapPlot can write a text file that approximates the graph. 
    
      Process set to plot with LASERWRITER attached to gcgplot.ps
      using the psd graphic interface.
    
     (Linear) MAPPLOT  of what sequence ?  a10852.gb_pat
    
                      Begin (* 1 *) ?  
                    End (*   780 *) ?  
    
     ***  I read your enzyme data file "enzyme.dat"!!  *** 
    
     Select the enzymes:  Type nothing or "*" to get all enzymes. Type "?"
     for help on which enzymes are available and how to select them. 
    
                                           Enzyme(* * *):  
    
     PostScript instructions for a LASERWRITER are now being sent to gcgplot.ps.
    
    
    You can now bring the gcgplot.ps file back to your own machine using a file transfer program such as Fetch or FTP.

    2. Use GCG's "Figure" option. Any Wisconsin Package graphics program run with -FIGure on the command line writes a source file of plotting instructions (called a figure file) that can be used as input to Figure. You then run 'setplot', choose that the output be sent to a file. Then run 'Figure' with the output file from your GCG graphics program. An advantage of making figure files from Wisconsin Package graphics programs is that you can store a graph and then replot it several times on different devices or make several copies of the same plot without having to redo an entire analysis.

    Sample session:
    helix% pepplot -fig
    
    PepPlot plots measures of protein secondary structure and
    hydrophobicity in parallel panels of the same plot. 
    
     PEPPLOT of what protein sequence ?  d44555.genpept
    
                      Begin (* 1 *) ?  
                    End (*   413 *) ?  
    
     The minimum density for a one-page plot is 359.1 residues/100 platen units.
     What density do you want (* 359.1 *) ?  
    
     What Panels do you want to plot?
    
         a) Sequence
         b) Charged-polar-hydrophobic residue schematic
         c) Beta forming-breaking symbols
         d) Chou-Fasman Alpha-Beta prediction curves
         e) Alpha forming-breaking symbols
         f) Chou-Fasman NH2-end prediction curves
         g) Chou-Fasman CO2-end prediction curves
         h) Chou-Fasman Turn    prediction curve
         i) Helical Hydrophobic Moment for Alpha and Beta
         j) Hydropathy and Hydrophilicity
    
     Please choose one or more (* ABCDEFGHIJ *):  
    
     FIGURE instructions are now being written into pepplot.figure.
    
    helix% figure
    
    Figure makes figures and posters by drawing graphics and text
    together. You can include output from other GCG graphics programs as
    part of a figure. 
    
      Process set to plot with LASERWRITER attached to gcgplot.ps
      using the psd graphic interface.
    
     FIGURE from what file ?  pepplot.figure
    
     PostScript instructions for a LASERWRITER are now being sent to gcgplot.ps.
    
    The file gcgplot.ps can be brought back to your own machine using a file transfer utility such as Fetch or FTP, and then printed to a postscript-compatible printer.


    How can I modify a GCG graphics figure for publication?

    If you saved the graphics as a PICT file, say from your Versaterm Pro on a Mac, you can in theory import it into a Mac graphics program and modify it. However, the GCG graphics is saved as a bitmap, and you will have a hard time modifying it and making it presentable. You may be able to do something simple like add an arrow, but that's about it.

    There are a couple of alternatives:


    How do I know if my setup can display GCG graphics?

    Your connection software needs to be able to do Tektronix emulation, or else you need X-terminal emulator software in order to display GCG graphics on your desktop machine. We know that the following configurations will work:
    Type of machineCommunication Softwareemulates
    MacVersaterm ProTektronix
    PCSmarTermTektronix
    PCExceedX-terminal
    Unix workstationX-windowsX-terminal

    For other configurations, look through the documentation to see if it can do Tektronix emulation.

    If you don't see anything about Tek emulation, chances are that you can't display GCG graphics on your screen. If you don't want to purchase new connection software, you can still print out the graphics -- see the section on Printing in the FAQ.


    What do I do with a figure file?

    You ran a GCG graphics program, and selected 'figure' as the output option. Now you have a GCG figure file, and don't know how to print or display it.

    The main advantage of getting your output as a figure file is that you can edit the file if you really know what you're doing. You can scale, shift, and modify the graphics as you want, but you have to learn the options in the GCG figure command. It's not that hard, but if you want a simple output and are not interested in manipulating it, the figure output file is not much use to you. Instead, look at the Graphics section of this FAQ to see how to get the graphics displayed on your screen, or see How do I print GCG graphics to my postscript printer.

    But suppose you already have a figure output file, and don't want to run the program again to get a different output? You can still use the GCG figure command to get your output into print or displayed on your screen. Type 'setplot', choose the appropriate option, and then run figure.

    Sample session: printing a figure file

    helix% setplot
    
    +---------------------->  displaying all of 7 option(s)  <-------------------+
    |mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen
    |pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]
    |colorX     Color X Windows Graphics Window
    |monoX      Monochrome X Windows Graphics Window
    |lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps
    |EPSF       to generate encapsulated popostscript file ->gcgplot.epsf
    |HP7550     to select a HP7550 plotter file ->gcgplot.gl
    |                                                                            |
    |                                                                            |
    |                                                                            |
    |                                                                            |
    |                                                                            |
    +----------------------------------------------------------------------------+
    Enter a command. Choices are:
               and  scroll the list
               makes GCG use the selected device
              Q quits without doing anything
    
              C creates and edits a new device
              (you can't delete from the site file)
              V views the selection (use C to edit a copy)
    
    Done
    
     
     Plotting Configuration set to: 
     
           Language: psd 
             Device: LASERWRITER
      Port or Queue: gcgplot.ps
    233% figure 
    
    Figure makes figures and posters by drawing graphics and text
    together. You can include output from other GCG graphics programs as
    part of a figure. 
    
      Process set to plot with LASERWRITER attached to gcgplot.ps
      using the psd graphic interface.
    
     FIGURE from what file ?  paupdisplay.figure
    
     PostScript instructions for a LASERWRITER are now being sent to gcgplot.ps.
    
    The file 'gcgplot.ps' can now be printed on any postscript-compatible printer.

    Sample session: Displaying figure file on your screen

    helix% setplot
    +---------------------->  displaying all of 7 option(s)  <-------------------+
    |mactek     Tektronix -- a Mac-Versaterm-Pro tektronix 4105 screen
    |pctek      Tektronix -- a tektronix 4014 screen [PC/Kermit]
    |colorX     Color X Windows Graphics Window
    |monoX      Monochrome X Windows Graphics Window
    |lwpost     to generate postscript for a Apple LaserWriter file ->gcgplot.ps
    |EPSF       to generate encapsulated popostscript file ->gcgplot.epsf
    |HP7550     to select a HP7550 plotter file ->gcgplot.gl
    |                                                                            |
    |                                                                            |
    |                                                                            |
    |                                                                            |
    |                                                                            |
    +----------------------------------------------------------------------------+
    Enter a command. Choices are:
               and  scroll the list
               makes GCG use the selected device
              Q quits without doing anything
    
              C creates and edits a new device
              (you can't delete from the site file)
              V views the selection (use C to edit a copy)
    
    Done
     
     Plotting Configuration set to: 
     
           Language: tekd 
             Device: VERSATERM-TEK4105
      Port or Queue: term
    
    238% figure
    
    Figure makes figures and posters by drawing graphics and text
    together. You can include output from other GCG graphics programs as
    part of a figure. 
    
      Process set to plot with VERSATERM-TEK4105 attached to term
      using the tekd graphic interface.
    
     FIGURE from what file ?  paupdisplay.figure
    
     When your VERSATERM-TEK4105 attached to tty is ready, press .
     
    helix%
    
    This sends the graphics directly to your Tektronix emulation window. Note that this will work only on a Mac running a Tek emulation package such as Versaterm Pro.