NEW REPORT







Syntax




   NEW REPORT @name ENTRIES (1:15)@quantity
 
   NEW! REPORT @name ENTRIES (1:15)@quantity


Description




The NEW REPORT command is used to define the contents of a report that you plan to produce. The report is made up of a name of your choosing and the entries that you wish to have appear in the report.

If a report has already been defined, issuing a NEW REPORT command will cause PERCY to warn you that the report has already been defined. PERCY will not overwrite the existing definition. If you want to overwrite an existing report definition you can either FORGET the report (using the FORGET REPORT command) and then redefine the report, or you may use the NEW! REPORT version of the command. When this syntax is used, PERCY overwrites any existing definition without issueing a warning.

You can see a list of all defined reports by telling PERCY to

   SHOW LIST OF REPORTS
To see a description of a particular report from the collection of defined reports, issue the command

   SHOW REPORT <report_name>


Entries



The entries of a report are the various quantities that you wish to have computed and represented in a tabular report. The entries of the report need not be defined at the time you define your report. However, before the report is generated you will need to make sure that all of the entries have been defined using the NEW QUANTITY command.

Since the rows of a report are a function of time, you will usually want one of the entries of the report to be a time quantity in one of the various allowed formats. TIME WILL NOT BE SHOWN IN A REPORT UNLESS YOU EXPLICITLY DEFINE IT TO BE PART OF THE REPORT.



Examples




The following commands create a report that will contain the right ascension and declination of the moon as a function of UTC time.

   NEW QUANTITY TIME DESCRIPTION TIME FORMAT UTC HEADING "Time" NO LEGEND;
 
   NEW QUANTITY RA_MOON DESCRIPTION FRAME J2000 RA OF 301 FROM 399
   UNITS DEGREES FORMAT X.XXXXXXX HEADING "R.A";
 
   NEW QUANTITY DEC_MOON DESCRIPTION FRAME J2000 DEC OF 301 FROM 399
   UNITS DEGREES FORMAT X.XXXXXXX HEADING "Dec.";
 
   NEW REPORT MOON_RA_DEC ENTRIES TIME RA_MOON DEC_MOON;


Related Topics




  1. About Reports
  2. Forget Report
  3. New Quantity
  4. The Percy Help System