Uploaded image for project: 'GMAT'
  1. GMAT
  2. GMT-3851

Document OrbitView view definition controls

    Details

    • Sprint:
      R2013b Milestone 6, Agile Trial

      Description

      This is a user request from DAQ.

      The camera view definition controls in OrbitView currently are not intuitive, based on user feedback. They require a lot of guesswork and fiddling with numbers to get the view right.

      A lot of this comes down to providing explanations of what the view controls mean, and labeling them in an intuitive way.

        Gliffy Diagrams

          Attachments

            Activity

            Hide
            jjkparker Joel Parker added a comment -

            Doing something to improve the user-friendliness of the OrbitView controls was rated as one of DQ's top-5 P1 issues (SSMO). But it doesn't need to be all the way: simply documenting the existing controls in an intuitive way would be a suitable first improvement.

            Show
            jjkparker Joel Parker added a comment - Doing something to improve the user-friendliness of the OrbitView controls was rated as one of DQ's top-5 P1 issues (SSMO). But it doesn't need to be all the way: simply documenting the existing controls in an intuitive way would be a suitable first improvement.
            Hide
            jjkparker Joel Parker added a comment - - edited

            In particular, DQ mentioned that simply emulating STK's approach (eventually) may not be the best answer; theirs is plenty confusing on its own.

            Show
            jjkparker Joel Parker added a comment - - edited In particular, DQ mentioned that simply emulating STK's approach (eventually) may not be the best answer; theirs is plenty confusing on its own.
            Hide
            shughes Steven Hughes added a comment -

            Start by documenting better. I sent an email in late fall with the spec that shows a diagram of how the user configurable options map to the view geometry. We need to add that figure and explanation to the documentation.

            After documentation work with some users to assess the interface.

            Show
            shughes Steven Hughes added a comment - Start by documenting better. I sent an email in late fall with the spec that shows a diagram of how the user configurable options map to the view geometry. We need to add that figure and explanation to the documentation. After documentation work with some users to assess the interface.
            Hide
            shughes Steven Hughes added a comment -

            See section 17.1. You can probably cut and paste from a lot of this. We need to include the diagram shown in Fig. 17.1 and include key examples for common configurations. EarthFixed, MoonInertial, SatRelativeMotion, Libration Point, and maybe a few others.

            Show
            shughes Steven Hughes added a comment - See section 17.1. You can probably cut and paste from a lot of this. We need to include the diagram shown in Fig. 17.1 and include key examples for common configurations. EarthFixed, MoonInertial, SatRelativeMotion, Libration Point, and maybe a few others.
            Hide
            rqureshi Rizwan Qureshi added a comment -

            This ticket is related to GMT-3318 & both tickets are VERY identical

            Show
            rqureshi Rizwan Qureshi added a comment - This ticket is related to GMT-3318 & both tickets are VERY identical
            Hide
            rqureshi Rizwan Qureshi added a comment -

            Done with documenting OrbitView Definition Controls. Will commit, pull and push XML doc into repo soon.

            Show
            rqureshi Rizwan Qureshi added a comment - Done with documenting OrbitView Definition Controls. Will commit, pull and push XML doc into repo soon.
            Hide
            rqureshi Rizwan Qureshi added a comment - - edited

            done with documenting of View Definition Controls panel of OrbitVIew in Users doc. Also included examples and mathematical description of View Definitions panel. Please check 10/25 build or later User docs

            Show
            rqureshi Rizwan Qureshi added a comment - - edited done with documenting of View Definition Controls panel of OrbitVIew in Users doc. Also included examples and mathematical description of View Definitions panel. Please check 10/25 build or later User docs
            Hide
            shughes Steven Hughes added a comment -

            Hi RIzwan, this looks very good. I think we should take an hour and update text for style then close. We can meet to talk about the style changes. Mainly updating for active voice.

            "GMAT is capable of drawing orbit plots that allow the user to visualize the motion of spacecraft and celestial bodies"

            Would become

            GMAT is capable of drawing orbit plots that allow you to visualize the motion of spacecraft and celestial bodies

            Show
            shughes Steven Hughes added a comment - Hi RIzwan, this looks very good. I think we should take an hour and update text for style then close. We can meet to talk about the style changes. Mainly updating for active voice. "GMAT is capable of drawing orbit plots that allow the user to visualize the motion of spacecraft and celestial bodies" Would become GMAT is capable of drawing orbit plots that allow you to visualize the motion of spacecraft and celestial bodies
            Hide
            jjkparker Joel Parker added a comment - - edited

            I have a meeting with DQ scheduled for Friday 11/15; let me know if I should take this to him or not.

            Show
            jjkparker Joel Parker added a comment - - edited I have a meeting with DQ scheduled for Friday 11/15; let me know if I should take this to him or not.
            Hide
            rqureshi Rizwan Qureshi added a comment - - edited

            Updated the language of OrbitView spec to make language more direct and active voice.

            Show
            rqureshi Rizwan Qureshi added a comment - - edited Updated the language of OrbitView spec to make language more direct and active voice.
            Hide
            rqureshi Rizwan Qureshi added a comment -

            Hi Joel,

            I have updated the language of spec to make it more active voice. Yes it'll be nice if we can get users' input on the updates that I did on OrbitView's View Definition Control panel. I also included key examples in how to use View Definition Controls fields within View Definition Controls section of the spec.

            Showing it to DQ wil help us determine if we've made progress. This is why I'm temporarily assigning this to you.

            Show
            rqureshi Rizwan Qureshi added a comment - Hi Joel, I have updated the language of spec to make it more active voice. Yes it'll be nice if we can get users' input on the updates that I did on OrbitView's View Definition Control panel. I also included key examples in how to use View Definition Controls fields within View Definition Controls section of the spec. Showing it to DQ wil help us determine if we've made progress. This is why I'm temporarily assigning this to you.
            Hide
            jjkparker Joel Parker added a comment -

            I've presented this to DQ for feedback. See email chain related to that meeting from last year.

            Show
            jjkparker Joel Parker added a comment - I've presented this to DQ for feedback. See email chain related to that meeting from last year.

              People

              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: