.. C-Munipack - User's manual
Copyright 2012 David Motl
Permission is granted to copy, distribute and/or modify this document under the
terms of the GNU Free Documentation License, Version 1.2 or any later version published
by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and
no Back-Cover Texts.
$Id: profiles.rst,v 1.3 2012/11/17 08:31:55 dmotl Exp $
.. index::
single: profile
.. _profiles:
Profiles
========
Profiles have been introduced to provide way efficient way of coping with a situation where using
multiple distinct project settings is necessary, e.g. an observer uses multiple cameras or telescopes.
A profile keeps a set of configuration parameters that are presented in the :ref:`Project settings dialog
<project-settings-dialog>`. In general, all parameters that affect the data processing in some way are
handled by profiles.
Each profile is stored in the file system as a separate file. They might be stored in any directory, the
programs keeps track of the last folder used, but it is recommended to keep all your profiles in a single
directory. Profiles are distinguished by their name, the name is derived from the file name by trimming
the "cfg" extension.
The most frequent use of profiles is at a time of creating of a new project, where an initial set
of configuration parameters are loaded from a profile. A profiles can be created and updated using the
:ref:`Project settings dialog <project-settings-dialog>`.
.. index::
pair: profile; create
pair: profile; update
Creating and updating profiles
------------------------------
A new profile can be created using the following steps:
\(1) Start with a project - create a new project or open an existing one. Set up the parameters.
\(2) From the main menu select :menuselection:`Project --> Edit properties`.
\(3) Go to the root page (called `Project ...`).
.. figure:: images/project_profiles_couts1.png
:align: center
:alt: Load profile dialog
Saving settings to profile
\(4) Click the `Save to profile` button (11). A new dialog appears. Enter the name of the profile. You
can also change the location of the target file; if you do so, the program updates the location where
profiles will be searched for.
\(5) Confirm the dialog.
To update an existing profile, use the same steps as above and enter a name of the profile that shall
be updated.
.. index::
pair: profile; load
Using profiles when making a new project
----------------------------------------
Parameters can be loaded from the project when one is creating a new project.
\(1) From the main menu select : :menuselection:`Project --> New`. A new dialog appears.
\(2) Enter a project name. Adjust location of the new project if necessary. Choose project type.
Click the 'OK' button to proceed to the next page. See :ref:`this topis <new-project-dialog>`
for details.
\(3) Select the option :guilabel:`Import settings from a profile`.
.. figure:: images/loadprofile_couts2.png
:align: center
:alt: Load profile dialog
Loading settings from a profile
\(4) List of existing profiles is shown in the table (1). Select a profile that shall be used
to set up an initial parameters from the new project. See :ref:`this topic <load-profile-dialog>` for
details.
Applying profiles on an existing projects
-----------------------------------------
To load a the settings from a profile into an existing project:
\(1) From the main menu select :menuselection:`Project --> Edit properties`.
\(2) Go to the root page (called `Project ...`).
.. figure:: images/project_profiles_couts1.png
:align: center
:alt: Load profile dialog
Loading settings from profile
\(3) Click the `Load from profile` button (12). A new dialog appears. Choose the profile that shall
be loaded into the current project. You can also choose a file from another location; if you do so,
the program updates the location where profiles will be searched for.
\(4) Confirm the dialog.
.. seealso:: :ref:`projects`, :ref:`project-settings-dialog`, :ref:`new-project-dialog`, :ref:`load-profile-dialog`
