Installation Instructions ------------------------- Install this release of YESDAS Manager over your existing program. You will not loose any of your data files during this upgrade. -------------------------------------------------------------- YESDAS Manager 2.5.0.93 YESDAS Attendant 2.5.0.23 YESDAS Web Server 2.5.0.41 -------------------------------------------------------------- February 12, 2003 YESDAS Manager/Web Server Changes --------------------------------- The Langley Plot and Langley Report now have 2 new user definable parameters that modify the decision process of obtaining Langley Report data. The parameters are found by clicking on the Options button in the Data Manager windows of YESDAS Manager. You will find the previously added Airmass range selection for Langley Plots and Reports. The Langley Report now has 2 new parameters as defined by Lee Harrison's objective algorithm: The automated algorithms will only report data where the number of kept points is greater than five, and greater than 0.3 times the number of points available. In addition the standard deviation of the residuals of ln(I) around the regression must be less than 0.0060. The 2 parameters are the fractional number of points, the default 0.3 and the sigma limit 0.0060 where sigma refers to the uncertainty of the optical depth. Fractional Points: 0.25 (less strict) ... 1 (more strict), default 0.3 Sigma Limit: 0.003 (more accurate) ... 0.12 (less accurate), default 0.0060 These ranges have been established by Lee Harrison. It is highly recommended to use the same parameters for intercomparison evaluations. =============================================================== -------------------------------------------------------------- YESDAS Manager 2.5.0.91 YESDAS Attendant 2.5.0.22 YESDAS Web Server 2.5.0.39 -------------------------------------------------------------- December 23, 2002 Windows 2000 and Windows XP Support ----------------------------------- This version of YESDAS Manager now supports the Windows 95, 98, Windows NT (SP6a), Windows 2000 and Windows XP platforms. YESDAS Manager/Web Server Changes --------------------------------- The Langley Plot were previously configurable to specify different airmass ranges, but the Langley Report was not. In this release, the Airmass for both the Langley Plot and Report can be configured, and the setting is remembered. Data Manager Update ------------------- The Data Manager has been updated to execute on Windows and Linux in preparation for the upcoming RSS and UVRSS instruments. MFR/UV-MFR, RSS/UV-RSS Data Manager v5.18b - 03/29/2001, 12/06/2002 (Win32 and Linux) The portable portion of the Data Manager specifically contains the Harrison Object Langley Algorithm for producing Langley Plots and Langley Reports. Documentation ------------- This release contains an updated manual. -------------------------------------------------------------- YESDAS Manager 2.2.0.82 YESDAS Attendant 2.2.0.18 YESDAS Web Server 2.2.0.33 -------------------------------------------------------------- May 31, 2001 YESDAS Manager -------------- The O command value was incorrectly determined. This problem has been fixed and affected only firmware YES7P2A or later. Please refer to the release notes from November 27, 2000 for further information. -------------------------------------------------------------- YESDAS Manager 2.1.0.78 YESDAS Attendant 2.1.0.17 YESDAS Web Server 2.1.0.32 -------------------------------------------------------------- April 2, 2001 YESDAS Manager and YESDAS Web Server ------------------------------------ A QED error resulted in incorrect comparisons of values. This has only affected QED files with >= or <= operators. The problem is now fixed. The Data Manager version is now: v5.18b - 03/29/2001. -------------------------------------------------------------- YESDAS Manager 2.1.0.77 YESDAS Attendant 2.1.0.16 YESDAS Web Server 2.1.0.31 -------------------------------------------------------------- November 27, 2000 YESDAS Manager -------------- The Wizard now opens the correct objects - this only affected customers who had existing objects in the YESDAS network. Implemented the O command for the data logger Firmware YES7P2A and newer. The O command allows the motor to be mounted at a fixed position regardless of the current latitude. The YESDAS Profile has a new field: Motor Angle in which you can specify the default (which is the current latitude of the site) or a specific motor mounting point. The O command improves calculations in the data logger. Upon starting the YESDAS Manager the first time, the user is asked whether they would like to run the Setup Wizard. The date/time setting in the Attendant Job was incorrect. The time appeared as a date and did not allow the user to select a time. YESDAS Web Server ----------------- Improved Internet Explorer 5.0 Support. YESDAS Attendant ---------------- Improved session hangup handling, so that your system does not lock up. One had to clear a hung session by hand which at this point should not be necessary. -------------------------------------------------------------- YESDAS Manager 2.0.0.68 YESDAS Attendant 2.0.0.11 YESDAS Web Server 2.0.0.25 -------------------------------------------------------------- December 29, 1999 Known Problems in This Release ------------------------------ Closing the YESDAS Manager terminal window can sometimes result in a program exception, especially if the terminal window was just opened and the PC is busy with other tasks (or has a slower CPU). If this happens, YESDAS Manager will appear to still be running but will complain if you then try to re-open the terminal window again. This problem is much more prevalent under MS-Windows 95 and is caused by a longer-than-normal response period following an operating system request to close the serial port hardware. The only work-around as of this writing is to either close YESDAS Manager and restart the program, or use MS-Windows NT. If you observe exception errors in the YESDAS Attendant log, but all data appear to be present (that is, the Attendant otherwise appears to be doing its job of collecting data successfully), you should increase the time interval between scheduled downloads. This problem appears most frequently on MS-Windows 95 PCs, and when the download interval is set to every 5 minutes. This problem is related to the previous issue as the Automated Attendant runs the terminal emulator in an automated mode. As a registered user you can check for new versions and software patches at our corporate web site, www.yesinc.com or at our on-line services page. YESDAS Web Server ------------------------------------------------- The YESDAS Web Server can now bind itself to a userdefined IP address. The issue is that when a host has multiple IP interfaces, you may want to be able to control which particular IP interface the YESDAS Web Server is bound to. This would allow you to publish different web views on different IP addresses from a single host. Your host would require multiple IP address assignments. Leaving this assignment empty means that the YESDAS Web Server binds itself to all active IP interfaces on the host that it is running. YESDAS Manager ------------------------------------------------- RSRSplit had inadvertenly a sanity check that only allowed it to work on xmd files dated before Dec 7, 1999. This has been fixed. Subject line of jobs are now customizable. SMTP support for email has been added. The Attendant now has the ability to synchronize its time not only to the local PC clock but also to the default Time Server. The Time Servers are defined in the Network object of the YESDAS Explorer. To enable Time Server time synchronization, check the Initialize Time via Network Time Server in the YESDAS Attendant Job definition. This option should only be used on a PC that has a permanent connection to the internet (i.e. not a dial up - unless the dial up guarantees that it won't ask question that the user must answer and the dial up should occur within 30 seconds or less. Most TCP transmissions will timeout otherwise. If this is not an option we are providing two tools from NIST to solve the PC time synchronization problem. NIST Time & Frequency Division ------------------------------------------------- Two tools have been included in this software that allow you to easily synchronize your PC time with an authorative time server. The YESDAS Manager also includes a Time Service tool which is designed if your PC is has a permanent internet connection. Use the NIST provided tools with PCs that do not have a permanent internet connection. The ACTS tool is for modems, and the NTS tool uses the IP protocol to get the time. NIST Automated Computer Time Service (ACTS) ------------------------------------------------- http://www.bldrdoc.gov/timefreq/service/acts.htm NIST Network Time Service (NTS) ------------------------------------------------- http://www.bldrdoc.gov/timefreq/service/nts.htm -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.65 YESDAS Attendant Beta 1.0.0.10 YESDAS Web Server Beta 1.0.0.24 -------------------------------------------------------------- October 25, 1999 -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.65 -------------------------------------------------------------- The DOWNLOAD process would produce a syntax error if the data stream contains a ??. This has been fixed to ignore that. -------------------------------------------------------------- YESDAS Web Server Beta 1.0.0.24 -------------------------------------------------------------- The YESDAS Web Server did not process HTTP POST requests properly causing it to display YESDAS Data Manager Error messages. This problem has been fixed. -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.64 (not release to public) -------------------------------------------------------------- September 20, 1999 Under NT the YESDAS Manager created errors being unable to create registry keys under the hive CLASSES_ROOT. This is due to the fact that a non-admin user has no rights in that hive. The software wrote into that hive to ensure that the CORRECT settings are always in place even if you move the software to another location. This was to ensure that you would not have to 'reinstall' the software. This update remedies that. -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.63 -------------------------------------------------------------- September 17, 1999 Emergency Re-release of the September 15, 1999 software The YESDAS Manager could apparently NOT invoke rsrsplit when the YESDAS Manager was installed in a path that contains spaces. This was the case for example with C:\Program Files\YESINC\... This version has fixed this problem. The QED Editor has some minor visual changes, such as a toolbar button for deleting channels. Future enhancements will follow. -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.62 YESDAS Attendant Beta 1.0.0.9 YESDAS Web Server Beta 1.0.0.21 -------------------------------------------------------------- September 15, 1999 YESDAS Manager QED Editor ========================= QED Editor Addition: The QED Editor now allows the easy editing of the existing Cal/Sol files. The QED editor is now the primary tool for editing YESDAS Profile Configurations. Prerequisites: Your current channel profile must match your current cal and sol files. The QED editor detects differences and reports them to you. You then must adjust the number of channels selected to match the cal sol file configuration. After you have synchronized this QED editing is simple. You can add/remove channels using the QED editor ONLY if you have NO data files in that profile. Create a new profile if you want to add new channels. You can ALWAYS modify the calibration file even after you have downloaded data. To add a new channel simply type the name of the channel in the Channel Configuration tab and press . To remove a channel simply delete the name of the channel in the Channel Configuration tab and press . After adding a channel you should proceed with creating a formula that creates the calibrated output value. Proceed with the QED Program tab. You will notice that the QED Program is showing you *.cal file. The QED Program Editor HIDES the PRODUCES section you seen in the *.cal files. In addition to that it changes how 3 functions' parameters are laid out: OUT(n,r) --> OUT("OutputHeading","Unit",n,r) IOUT(n) --> IOUT("OutputHeading","Unit",n) DATA(r,d) --> DATA(RowOffset,"DataColumnName"|DataColumnOffset) The OUT statement has 2 addition parameters that are from the PRODUCES section. Previously, the order of the OUT/IOUT statements had to match the entries in the PRODUCES section. To avoid the matching up game we now merge the PRODUCES section data into the OUT statements. The DATA() function used to specify the data output column in the second parameter. This causes a lot of confusion when adding counters and all the time channels to your setup because all these offsets change. Now we replace those offsets with human readable labels (specifically the channel!type labels such as "672.5nm!Diffuse" which clearly indicates the 672.5nm Diffuse. To save yourself the typing work we have the OUT and DATA button in the toolbar. The OUT button invokes a wizard which asks for the output column name, the unit and data type. The DATA button drops down the «Data Columns» and after clicking on an entry produces the entire DATA() function for you. If you click ONLY on the «Data Columns» drop down and select an entry the ONLY the second parameter of the DATA() function is typed for you. Tip: Click on the DATA() button instead. The toolbar has buttons for finding text, cutting, copying, and pasting. It also includes timesavers for easy function, operators and variables inserting. The variables are being kept track of as you write your QED code. After saving your changes the original cal/sol files are backed up as *.backup files. YESDAS Manager ============== International users caused the YESDAS Manager numeric fields to function improperly, such as causing GPFs when it should not. Also, the INI files where not properly read when it came to floating point values, such Latitude and Longitude. This has been corrected. The Raw Real-Time views in the Terminal window did not reflect Counter channels if they were set to greater than 1. Double-clicking on an icon in the Explorer window now works. Previously it would ignore that. There was a serious file contention problem with the Attendant, Manager, and Web Server when multiple processes would read from ini files simultaneously. Now we have implemented a lockINI.lock file which is open exclusively to prevent multiple reader/writer collisions on .INI files. The lockDATA.lock is for .xmd and .mtm file exclusions which was called data.lock. You may now safely remove all data.lock files if you wish. The problem appeared as if the Web Server and YESDAS Manager were both blocked. It appears to happen on some network environments. The CAL and SOL files are now properly associated in the Windows Explorer with the NOTEPAD.EXE file. That way you can double-click on them for editing and viewing purposes. When running attendant jobs there was the possibility of a YESDAS Manager if someone changes the Communication Profile name of the YESDAS Object to an invalid name. Now it won't crash, and will log the problem. NOTE: The situation of not finding objects in the YESDAS network results in NO email log. rsrsplit (Data File Merge) ========================== Attempting to merge more than 1000 files causes the procedure to hang. Cause is that even so Win95/NT have no limit on the number of open file handles, there is a limit of placing the file handles in only non-paged memory. This is obviously machine and process dependent and at this point we only permit a max of 1000 files to be merged. Under low memory conditions that can fail. Recommendation: once the Day files a checked and acceptable, merge those into bigger files, such as Month and Year files, instead of starting the merge with the original downloaded files (if you download every 10 minutes you will have a lot!) At this point you can only process a maximum of 1000 files. The rsrsplit utility may fail to open files with message to the notion of 'Unable to open file' or 'File not found'. When that happens attempt to select fewer files. A bug is fixed that caused rsrsplit.exe to crash with a general protection fault when closing file handles that were already closed or never opened. A file header change in the All-the-Time, Daytime-Only, and Counters was not actually detected by rsrsplit, causing it to merge non-matching files. The head id, board id, and solar channels always were detected correctly. This has been fixed. YESDAS Web Server ================= The Uncalibrated Solar Gallery now also includes the Langley AM, PM plots formatted so that there are 3 plots per line in the browser: the standard Solar Plot, Langley AM and Langley PM. As the user changes the 'Reload' event we are now clearing the previous event select. This was a bug in earlier versions where the browser would continuously reload all sorts of timed events causing it to eventually crash. When selected the last file in a file list, the data graphs where not necessarily refreshed unless the user had chosen the refresh checkbox. This is fixed. Whenever the user chooses the last file in a list it is assumed that the file's data contents might change potentially from request to request. Therefore a forced refresh is requested for the last file in the file selection box. Added a 10 minute refresh interval option which is useful for extremely slow IP links. -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.59 YESDAS Attendant Beta 1.0.0.7 YESDAS Web Server Beta 1.0.0.19 -------------------------------------------------------------- July 26, 1999 YESDAS Manager ============== Improved the terminal shutdown procedure to avoid potential access violation errors in windows 95. Windows NT was not affected by that. Fixed a user interface problem when pressing Shift-F10 in any of the Web Server Lists, Job Lists, File Lists when there was nothing listed. At this point a menu will appear instead of simply crashing the program. YESDAS Web Server ================= Improved the Layout and Visual Design of the YESDAS Web Access Interface. The Web Server now stores the log file under the YESDAS Network directory. The log file will continuously grow just as a regular web server such as Apache and others would. The Web Server now refreshes the published profiles on its own every 10 minutes. There is a menu choice Options, Refresh which performs the same action. -------------------------------------------------------------- YESDAS Manager Beta 1.0.0.54 YESDAS Attendant Beta 1.0.0.3 (prev. release was doc'd as 1.0.0.9 which was incorrect) YESDAS Web Server Beta 1.0.0.13 -------------------------------------------------------------- July 12, 1999 This release includes the YESDAS Attendant and the YESDAS Web Server. YESDAS Attendant ================ The Attendant is a virtual person which makes sure that your computer connects, downloads, verifies the downloads, automatically archives the data into Day files and much more. Each YESDAS in the Network/Site/YESDAS hierarchy may require some sort of automated downloading and maintenance. You have the ability to create multiple jobs per YESDAS. Job Definition -------------- - execution time - the job frequency (repeat every x minute(s)/hour(s)/day(s)) - the machine the job needs to run on (this gives you the ability to have multiple machine in the YESDAS network perform downloads - the best thing is to be able to reschedule a job to another machine if one is down) - should the YESDAS be restarted if a powerloss is detected (this will also download existing data - i.e.: memory recovery) - should the YESDAS be restarted if it was halted (again, get data if there is any) - should the memory card be erased after a download (you might not want to - if the amount of data you are collecting is very small - remember you must have at least 128 bytes of data before a download even succeeds - so you could set up one job to constantly get data and another run once during the day that clear the memory card). - merge the downloaded data with the day files - this option is a MUST when we deploy the web interface for this system - since it will only present Day files at first; definitely not pure downloaded data. - email the job log to the site/network operator - post process files (you can postprocess the downloaded file allowing you to output the langley report and/or the calibrated data to a file. You can also postprocess the modified Day Files - this is only sensible if the Merge downloaded data with Day files is on - which it does for you. If you specify no files names for the postprocessing the system will use the name of the downloaded file with the .lan/.txt extensions for langley report and calibrated output data respectively. In the case of the post processing of Day files you can only specify a target directory because the possibility exists that more than one day files was modified at once - this happens with any data that is collected over the period of midnight.) To define a job: ---------------- Select the YESDAS, choose Properties and click on the Attendant Jobs tab. Press the right mouse button in the empty list and choose New. Specify a job name and the job parameters. After choosing OK the job is scheduled and if you left the YESDAS Attendant Computer Name alone it will run on your machine. You will see the YESDAS Attendant start automatically. It appears in the system tray of your taskbar (i.e. lower right corner of your monitor). There is also a StartUp icon in your Start|Programs|StartUp menu with the name of the YESDAS network. You can press the right mouse button on a job to: - create a new job - delete a job - rename a job - refresh the job list - especially when you believe it is not right (the scheduling time might not appear correct if the job was not run for a long time and then you enable it again) - test run - do that - this to actually see what the attendant will do Attendant Icon -------------- Click on the YES icon in the system tray and you will see a menu if the following choices: - YESDAS Manager - will start guess? - View Schedule - the schedule of the attendant on the machine it is running - View Log - the log of the attendant itself (this log is not saved anywhere) - About - Exit - will shutdown the attendant - restart it by going to the Start|Programs|StartUp|... Attendant Scheduling: --------------------- The attendant scheduling is forward thinking. For example: if a job was scheduled for 3:30pm on June 1, 1999 and the job is supposed to run every hour and you had NOT been running the attendant since then the Attendant will automatically forward the time to a point where the job is runnable again. I.e.: it will increment the scheduling time by 1 hour (it was supposed to run every hour) until the time is greater than or equal to now. This saves you from having to reschedule a job that has not been run for a while. This also has the advantage of being able to disable a job for a while and then simply re-enabling it without having to change the start time. Attendant Email: ---------------- The Attendant can email the log files via MAPI (Microsoft's Mail Application Programming Interface). In the Network and Site objects you can define email recipient(s). Multiple recipients can be specified by using a semicolon. Normally you can leave the Profile Name blank. The Profile Name is the Microsoft Inbox Profile Name. Since Microsoft calls it the Profile Name we chose to keep it that way. Special note for GroupWise users: you may not be able to get it to work unless you create a new profile, call it YESDAS, and specify only the Novell GroupWise Address Book and the Message Store - but not the Personal Address since it will keep asking you to possibly confirm email addresses when the Attendant is running. To modify the Inbox Profile, click the right mouse button on the Inbox and choose Properties and choose Show Profiles to begin with. Copy the existing one and remove the Personal Address from the copy (not the original). Web Server ========== The YESDAS Web Server has the ability to publish object information, such as Network, Site, YESDAS, Profile and also the downloaded data files. The YESDAS Manager allows you to define several YESDAS Web Servers run as independent processes on either one machine or on multiple machines. This features allows you to specify which YESDAS Profiles you wish to publish on which YESDAS Web Server. For example: an intranet YESDAS Web Server could publish every YESDAS Profile and its data while another YESDAS Web Server could publish a specific profile only. The YESDAS Web Server require the TCP/IP stack to be installed on a at least 150 Mhz Pentium with at least 32MB of RAM. These specifications can change based on how you configure the server. To setup a YESDAS Web Server ---------------------------- In the YESDAS Manager select the network object (topmost in the YESDAS Explorer). Press the right mouse button and choose Properties. Select the Web Servers tab and press the right mouse button in the empty list. Choose New and give the web server a name. The name can be the name of your host or anything else you choose. Define the port number to 80 (if you already have another web server on that port change it to something different). After performing that step the YESDAS Manager sets up a StartUp group icon so that the Web Server starts when you login to your machine. Note for NT Users: The YESDAS Web Server does not currently run as a NT Service. Neither does the Attendant. They both must be run from within a logged in session on the NT server. Windows 95 does not support services. To enable a YESDAS Profile to be published, simply choose the profile and its properties and select the appropriate YESDAS Web Server checkbox. When done close the web server and restart it via Start|Programs|Startup|___ Web Server. This will be fixed so that this happens differently in the future. The web server can be access via Netscape or Internet Explorer version 4 and above on both should be fine. The browser must support HTML frames and JavaScript 1.1. Known issues: ------------- - web logs are not saved - the explorer view is not refreshed - interface on the net/site/YESDAS/profile needs to be improved - live refresh on data files needs implementation ---------------------------- YESDAS Manager Beta 1.0.0.50 ---------------------------- June 9, 1999 Beta 1.0.0.50 has the following bug fixes: ---------------------------------------- Double-clicking on an XMD file caused the XMD window to appear over and over again until the machine runs out of RAM and crashes. The problem was only occurring IF you double-click on a file in a file list which contains only ONE file. Beta 1.0.0.50 has the following changes: ---------------------------------------- The YESDAS Explorer does not list data files anymore. The feature was nice but once you have 100 files it was annoying. The YESDAS Manager now has data file management capabilities: such as being able to split up multiple xmd files into 'Day' files, or taking a series of files and merging them. To use these features download some data (do things like downloading the same data twice while the data logger is running, the data files simply become larger over time; or try downloading, stopping, re-starting the data logger. Then go into the Profile Data Files view. Todo that, do one of the following: 1. Double click on a Profile object in the YESDAS Explorer 2. Press the right mouse button on a Profile object in the YEDAS Explorer and choose Data Files 3. Press the right mouse button on a Profile object in the YEDAS Explorer and choose Properties and then go to the Data Files tab. Choice 1 is the fastest. In the Data File tab you are presented with 4 sub tabs. 1. The Downloaded Files tab contains files you just downloaded. 2. The Downloaded and Filed Files tab contains files you have Merged with the Day files. (The files in this folder are also marked as read-only by the YESDAS Manager) 3. The Day files contain files for each day you have taken data. Each file starts at midnight and ends at midnight (to be exact: if you are sampling every 60 seconds, then the first data point is timestamped with the first minute of one day and the last data point is timestamped with the first minute of the next day. So you will always see TWO dates in those files - BUT - only ONE day's worth of data.) 4. The Other files contain the cal/sol and any other kind of data files. Now some detail on file name extensions: The XMD extension means XMODEM Data File. The MTM extension which you will find in the Day Files and Other Files means Midnight To Midnight. To actually split/merge data press the right mouse button on any file (or files - select multiple files using the standard windows mechanisms), and select from the popup menu (you can also press Shift-F10 another windows standard key which also works in the YESDAS Explorer) Open: opens the xmd or mtm file. Open and Graph: opens the xmd or mtm file and proceeds to go to the Calibrated Graph page. You should check the Automate Angle Corr. checkbox if it says the data has not be angle corrected. Merge with Day files: merges the data with the existing day files. Behind the scenes this process is a bit more complicated than simply running rsrsplit. You will find that rsrsplit is run possibly multiple times. The execution log is color highlighted based on its actions. Merge/Split...: merges the selected data with the goal to make ONE data file - BUT - that does not always work. You need to specify the maximum gap time. If there are data gaps between files and the Maximum Gap value is 0 then rsrsplit with start a new file. You probably would say, make the Max to be a large number and then it's done; only one problem - we have seen some cases where the merged file is not functional. This is under investigation. It basically works for a lot of cases but I do not necessarily recommend specifying 99 days to be the max gap time. That creates large data files containing data that will be ignored by the cal/sol file operations. Refresh: refreshes the view Windows Explorer: opens the windows explorer to the directory that you are in (nice for those who really want to blow files up - notice that the YESDAS Manager does NOT provide a mechanism for DELETING data files - that is up to the user!) Details on Day file merge: Let's say you have a bunch of data collected from some day up to 10:00 pm on Mar 13, you download the data and do stop and start the data logger. Running through the Day Merge you will end up with Day files ending with Mar 13th. So, now let's say it is Mar 14th around 8:00 am and you download again. Realize that the file you downloaded contains data since Mar13 10:00pm until Mar14th 8:00am. There is obviously going to be a problem if you split this file up into Mar13, and Mar14, because we already have a file with Mar 13 data. That is where the Day File Merge is smart and remerges the Mar 13 files for you on the fly. Another issue is the date/time in the data files. Lee Harrison's data files contains date/time stamps with units of UTC. When the data gets merged with the Day files (the DayYYYYMMDD date reference is YOUR LOCAL TIME REFERENCE and NOT UTC - even so the data IN IT has UTC units!), one needs to know the timezone reference that the rsrsplit program has to use. That timezone reference is in the SITE object of the YESDAS Explorer. The default is to use the host's time zone (i.e. here it is now UTC-4:00 and during non-daylight savings it's UTC-5:00). You can disable the host's time zone reference and choose you own if you want. If split data files and you see the wrong beginning and/or ending times and you are probably choosing the wrong time zone. If you have the wrong time zone simply change it and re-merge. Some words about the file management. Files that are just downloaded are simply XMD files. Files that have been merged with the Day files are XMD files and are READ-ONLY. That is how I distinguish the files. Day files begin with the letters Day and have the extension MTM. Other files fit into none of the previous categories. ---------------------------- YESDAS Manager Beta 1.0.0.49 ---------------------------- June 2, 1999 NOTE: BEFORE INSTALLING - YOU MUST UNINSTALL THE PREVIOUS BETA VERSION! If you choose not then you MUST remove the YESDAS DATA Manager icon and YESDASD.EXE file. You will not loose any data files by doing that. Fixes/Changes made to the YESDAS Manager ------------------------------------------------------------ 1. Removal of YESDAS Data Manager. It is now completely integrated into the YESDAS Manager. The XMD file extension is registered into the registry to allow easy opening of files. You can also drag and drop files into the YESDAS Manager. Tip: if the YESDAS Manager is minimized drop files onto the icon in the taskbar - but before letting the mouse button go, wait until the YESDAS Manager restores its position. This is a Windows feature. XMD files can be now view in different ways: a. Raw Data sheet which is like a spreadsheet. Press the right mouse button to get a context sensitive popup menu b. Raw Data Graph which allows you to choose different output columns and plot them. c. Solar Plot (this is what the original YESDAS Data Manager, WinBand, DOSBAND tools did.) It also include preview windows for langley graphs. A separate tab is provide to do the Langley reports. d. Calibrated Data sheet similar to the Raw Data sheet except that the data is calibrated. e. Calibrated Graph similar to the Raw Data Graph except that the data is calibrated. Important: Your .SOL/.CAL file automatically was placed into the directory where your downloaded files reside. You should simply pick the solar file in the Main tab of the XMD file window and choose Apply Solar Angle Correction. After that names have been assigned to the output columns of the Raw Date/Graph tabs. Also the columns may be re-arranged depending on the sol file layout. After that you continue with calibration of data, simply choose one of the Calibrated views (Date or Graph) and the first cal file is used. There should only be ONE cal file per YESDAS Profile. If you are using the YESDAS Manager menus that should be automatically taken care of. You can output your data sheets as ASCII data. You can plot your graphs on a printer (color supported), you can also copy the graphs onto the clipboard for easy insertion into other programs. Check out the 2 button on each graph page for more information. Raw Data/Graph and Calibrated Data/Graph have now the ability to present time in 3 different formats: a. Meridional Standard time b. UTC Date/Time c. Spreadsheet UTC Date/Time The meridional format allows me to create graphs that line up with Lee Harrison's Solar Plots. The date/time format in the prior version was fixed to UTC Date/Time which makes it not very easy reading the time values on the X axis. The spreadsheet UTC date/time was given for completeness. Notice that the Spreadsheet time now called Spreadsheet UTC date/time BECAUSE there is also an equivalent spreadsheet time for the meridional time. Raw and Calibrated Graphing now allows you to modify the line type, color, and line size. To use that add a column to the graph by clicking the check box to the left of the output column name. After you have done that you may press either the right mouse button on that column name and a popup menu appears. You may also press the Enter key on that item, if the column name has focus (an object has focus if there is a dotted line around it.) Some detail about line types. If you choose solid line then you can adjust the line size. If you choose any other kind of line, the line size is not changeable and is set to 1. You will notice that when you add a column to the graph, modify the line type, color, size settings, then remove the column from the graph, and then later add it back in, that the line type, color, size settings are preserved. They are not preserved if you close the window. For this reason we have created a new feature called Series Sets. A series is a data series displayed on a graph. This terminology 'Series' matches the standard Excel graphs. I have introduce a feature called a Series Set because it is definition that can include multiple series. For example, you want to display the UVMFR channel 314.1nm (Total, Diffuse, DirNorm). You would in the calibrated graph select each of those 3 different output columns. Since the chore of doing that can be annoying (especially if you have to do that over and over again) you can define that column selection as a Series Set. To save that series set, press the right mouse button or hit enter on any output column item, and choose 'Series Sets', and select 'Save As' you will be asked for a series name. You can alternatively save the current set with the current Series Set name if you want to overwrite a series set definition. To load a series set, go back to the Series Set menu and simply choose one of the prior save series sets. Special feature ONLY for calibrated graphs: If the output columns contain the label UVMFR or MFRSR the YESDAS manager automagically generates for you Series Sets that contain specifically the UVMFR/MFRSR channels with the appropriate colors and so on. This feature is what makes the calibrated graphing a real snap. No more do you have to select individual columns, fix their color and drive yourself nuts. 2. The Site Properties window can now be scaled vertically 3. The Profile Properties can be scaled to any size. 4. YESDAS Explorer menu icon additions 5. The terminal window now permits Raw Real Time Data and Graph views. You print/copy the graphs just like the XMD file analyzer can. 6. Site Object properties now also include the Local Noon report viewer in a calendar view. (This came from the previous YESDAS Data Manager, DOSBand, WinBand). 7. Tip Of the Day has been incorporated with many useful tips. If you turn them off, choose Help, Tip of the Day to turn the back on. ---------------------------- YESDAS Manager Beta 1.0.0.41 ---------------------------- April 2, 1999 Fixes/Changes made to the YESDAS Manager 1.0.0.41 ------------------------------------------------------------ 1. Underlying serial communication update and new compiler 2. When closing Application using the close button there would be Access Violations if one terminal window and two other property windows where open. This issue is solved. 3. Download problem of data. User either get aborted downloads due to xmodem block sequence error or out of trigger slots error - a series of events where firing during the download that were not expected to occur. The events would not cause problems for everyone but only some customers who have specific data in their xmd files. This issue has been reproduced and is solved. 4. Icons not displaying - this is an issue with a specific Microsoft DLL (COMCTL32.DLL) which is out of date. The YESDAS Manager now detects that and ask whether you would like to proceed with the 40COMUPD.EXE which is located in the support directory. We do NOT AUTOMATICALLY install that update during the SETUP. It is from Microsoft and is compatible with Windows 95 and NT. 5. Introduced an Action menu that shows context specific actions based on the YESDAS Explorer selected object Fixes/Changes made to the YESDAS Manager 1.0.0.35 ------------------------------------------------------------ 1. Underlying serial communication update 2. Network Time diagnostics (under the Network Object) 3. Status Window has an autorefresh 4. Delete has been implemented 5. Default YESDAS Profile can only be edited if connected and if the YESDAS is stopped. 6. Timeadjust factor now allows negative numbers. Refer to the YESDAS manual about the range of numbers. 7. If PCMCIA option 'None' is chosen, the Auto Transfer 32K is disabled. Fixes/Changes made to the YESDAS Data Manager 1.0.0.7 ------------------------------------------------------------ 1. Allow the user to perform a 'Plot' of raw (=not angle corrected data). This feature exists also in the DOSBAND version. 2. Allow the user to choose date and channel from drop down boxes. 3. Allow the user to define the x range on day plots and langley plots (airmass can be set from 1 through 7) 4. Implemented the printing of plots. Supports also color printers. Notice: ------------------------------------------------------------ We strongly recommend that you give us feed back via our Support web page at http://www.yesinc.com/support Copyright (c) 1998, 1999 Yankee Environmental Systems, Inc. Airport Industrial Park 101 Industrial Blvd. Turners Falls, MA 01376 US Telephone: (413) 863-0200 Fax: (413) 863-0255 Email: support@yesinc.com