.. index::
   single: G7 Reference Manual; D
   single: G7 Command; do 
   single: G7 Command; dos 
   single: G7 Command; dvam 
   single: G7 Command; data 
   single: G7 Command; del 
   single: G7 Command; dfr 
   single: G7 Command; dfreq 
   single: G7 Command; dir 
   single: G7 Command; diaginsert 
   single: G7 Command; diagextract 
   
*G7* Commands: D
================


.. _G7RMdata:

| **data <name>**
| **<date>  <observation1> ... <observationN>**
|    The *data* command introduces data into the workspace data bank.  There are two forms the command can take. 

   Form 1::

      data sales
        83.1  34.0 56.8 44.5 55.6
        84.1  39.3 41.2 43.9 47.0 ;

   The first number on each line is the date of the first observation on that line.  Input is terminated by a ";".  The ";" may be omitted in an add file except on the last line of the file. 

   Form 2::

      data sales 83.1
        34.0 56.8 44.5 55.6
        39.3 41.2 43.9 47.0 ;

   The date of the first observation is given on the command line immediately after the series name.  No dates appear on subsequent lines.

   Form 1 is easiest if the data is being entered by hand.  Form 2 is easier if the data is generated by a program.

   Input data may contain floating point numbers in exponential form.  Thus, the number 3 may be represented as 3.0, 3.0E+00,  0.300E+01, or 30E-01. Only E, not e, is recognized in this context.  Any number of spaces between data observations is allowed (the data are free format).

   A missing value may be represented by a single question mark (? ). Therefore ::

      data sales
         83.1  34.0 ? 44.5 55.6

   indicate that the sales for 83.2 quarter is missing.

   Related Topics: :ref:`frequency <G7RMfrequency>`, :ref:`matdata <G7RMmatdata>`, :ref:`update <G7RMupdate>`, :ref:`vdata <G7RMvdata>`


.. _G7RMdel:
   
**del <series name> [<series name2> [...]]**
   Delete the named series from the workspace data bank.  The last series is moved to the place of the deleted series.  The workspace bank file is not physically reduced in size by a deletion, but if another variable is added to it after the deletion, it will be put in the space formerly occupied by the deleted variable.  One or more series may be specified for deletion.

   Related Topics: :ref:`rename <G7RMrename>`


.. _G7RMdfr:
   
**dfr <bank_name> <bank_location>**
   The *dfr* command is used to assign a Dirfor file as a *G7* assigned bank. Dirfor files are files containing forecast results and historical data from a run of the Inforum LIFT model, or from one of the family of *SlimForp* international models.  (*SlimForp* is the predecessor to *Interdyme*.)

   These Dirfor files have a format described by a DIRFOR.DAT, or DIRFOR.CRD file.  After assigning a Dirfor file with this command, you will be asked to provide the name of the appropriate DIRFOR.DAT file.  Note that the DIRFOR.DAT file must point to the appropriate DIRHIS.DHS history file, as well as a correct MACRONAM.BIN list of macrovariable names.  The series names for *G7* will be formed by the concept name in the DIRFOR.DAT file, joined with the sector or category number.

   Related Topics: Assigned Banks, :ref:`bank <G7RMbank>`, :ref:`cbk <G7RMcbk>`, :ref:`hbk <G7RMhbk>`, :ref:`listbanks <G7RMlistbanks>`, :ref:`vam <G7RMvam>`


.. _G7RMdfreq:
   
**dfreq [0|1|2|4|6|12]**
   The *dfreq* command sets a default frequency for the left-hand side variable of an *f* command, when the right hand side does not have a frequency.  The default is 0, which means no frequency. Otherwise, frequencies are determined by the frequencies of the series on the right hand side of the *f* command.

   Related Topics: :ref:`frequency <G7RMfrequency>`

   
.. _G7RMdiagextract:
   
**(diage)xtract  <matrix_name> <vector_name)**
   This command takes the diagonal elements from the matrix and inserts them into the vector.  The vector and the matrix must be of the same dimension, and the matrix must be square.  One common use of this command is when you want to use the *index* command to move the A-matrix coefficients forward in time, excluding the diagonal.  In this case, extract the diagonal to a scratch vector, do the coefficient indexing, and then insert the diagonal back again.  

   Example::

      fdates 1998 2020
      diagextract am z     # am is the A-matrix; z is a scratch vector
      index 1998 mover am  # mover is a vector of coefficient change indexes
      diaginsert am z

   Related Topics: :ref:`diaginsert <G7RMdiaginsert>`, :ref:`index <G7RMindex>`


.. _G7RMdiaginsert:
   
**(diagi)nsert  <matrix_name> <vector_name>**
   This command is just the reverse of *diagextract*.  It inserts the elements of the vector into the diagonal of the matrix.  

   Related Topics: :ref:`diagextract <G7RMdiagextract>`, :ref:`index <G7RMindex>`

   
.. _G7RMdir:
   
**dir [arguments]**
   The *dir* command prints the contents of the current working directory.  The arguments are legal DOS arguments for the system *dir* command.  Note, however, that any '#' characters are interpreted as the *G7* comment delimiter, and so any text after '#' is ignored.  

   Example::

      dir t*.* # This command displays all files beginning with 't'.

   Note that the /p option will not function properly, because at present there is no means for the *G7* user to interact with the operating system in this case (where the user is prompted to hit a key after every page).  Because the *G7* window may be scrolled, the /p option is probably not needed.  If necessary, the following *G7* commands will allow use of the option, but the results will not appear in the *G7* output window. ::

      dos –i {dir t*.* /p; pause}
      dos –I dir t*.* & pause


.. _G7RMdo:

**do{ <G7 commands with variables> }[<Arguments>]**
   A *do* command allows you to run a set of *G7* commands like an *add* command without actually creating an add file.  Argument substitution is done just as in add files, where variables are %1, %2, etc.  A *do* command can continue on several lines.  However, the arguments should be placed on the same line as the closing brace mark '}'.  As with the *add* command, no more than 99 arguments are allowed, and the last two arguments may be groups.  

   Example 1::

      do{ gr out%1 65 97 }(1-87)  # graph output of sectors 1 through 87

   Example 2:

   The *do* loop can also make use of an if test in the loop.  Useful examples of the need for this capability would be: 1) special operations needing to be performed for particular industries; or 2) report displayed for particular iterations.  In this example, we iterate over values 1 to 10, and display the iteration numbers 1-3, 5, and 10. ::

      do{
         if( %1 < 3 || %1 == 5 || %1 == 10){
            ic Iteration %1
            }
         }(1-10)

   Related Topics: Command Files, Groups, :ref:`add <G7RMadd>`, :ref:`addtype <G7RMaddprint>`, :ref:`function <G7RMfunction>`

   
.. _G7RMdos:

| **dos [<dos command>]**
| **dos [<options>] [<batch file arguments>] <{...}>**
|    The *dos* command allows the passing of a DOS command to a temporary DOS shell.  Batch files can also be run.  When the DOS shell starts, you will see its output in the *G7* output window.  If the *dos* command is given with no arguments, then a DOS command window will open, and will remain open until you type *exit*.    

   Example::

      dos runmodel.bat

   To pass a group of commands to DOS, use the *dos{}* command.  The braces tell *G7* to create a temporary batch file containing the dos commands between the braces.  The temporary file is destroyed automatically upon completion.  Arguments may be passed to the batch file by listing them after the *dos* and before the opening brace.  Here is an example that copies a workspace bank to another bank::
   
      dos ws newws {
         rem Copying bank %1 to %2
         copy %1.ind %2.ind
         copy %1.bnk %2.bnk
         }

   When this *dos* command is given, the three lines after the opening brace are written to a temporary batch file, and then that batch file is called with the arguments "ws" and "newws", which replace "%1" and "%2" in the batch file, respectively.  The output of the batch file is written to the *G7* output window.
   If you would like to run DOS commands in interactive mode (e.g. when user input is required), use the "-i" option.  For example::

      dos –i idbuild master

   opens a command window and executes the program IdBuild with master as a command line argument.  If IdBuild requires user input, the user will see the prompt in the DOS window and can enter a response.  The same option is available in batch mode (using the braces.)

   
.. _G7RMdvam:

**(dv)am <bank_letter>**
   This command sets the default Vam file.  *G7* can have many banks open at once, and some of these may be Vam files.  Most commands that involve using vectors or matrices in a Vam file will operate on the default Vam file.  Each bank is opened at a different bank letter position, and that is that bank letter that should be given with this command.  A Vam file already must have been assigned as a bank before it can be made the default.  However, if several Vam files are assigned, the default can be switched from one to another as often as is needed.

   Example::

      vamcr vam.cfg hist # Create hist.vam with VAM.CFG as configuration file
      vam hist b         # Assign hist.vam in position "b"
      dvam b             # Make hist.vam the default vam file

   Related Topics: VAM.CFG file, :ref:`pmfile <G7RMpmfile>`, :ref:`vam <G7RMvam>`, :ref:`vamcr <G7RMvamcreate>`, :ref:`vf <G7RMvf>`, :ref:`vup <G7RMvup>`