Difference between revisions of "clean"

From GeneWeb
Jump to: navigation, search
(Clean (en))
 
m (A2 moved page Clean to clean: minuscule)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Cleanup of a base}}
+
{{DISPLAYTITLE:Cleaning up a GeneWeb database}}
 
{{languages|clean}}
 
{{languages|clean}}
 
+
This article explains how to '''clean up a GeneWeb database''' using [[man|command lines]]. This action is also available through the [[gwsetup]] interface.
This section explains how to cleanup a GeneWeb base using [[man|command lines]]. This action is also available through the [[gwsetup]] interface.
+
  
 
As you progress in the modification of your base, some issues may crop up:
 
As you progress in the modification of your base, some issues may crop up:
* after a lot of modifications, response time may increase;
+
* After a lot of modifications, response time may increase.
* if you add or modify families, consanguinity does not appear anymore or is incorrect;
+
* If you add or modify families, consanguinity does not appear anymore or is incorrect.
* if you suppress persons or families, the corresponding space in the base is not reclaimed (the total number of persons in the base does not vary after suppressions).
+
* If you suppress persons or families, the corresponding space in the base is not reclaimed (the total number of persons in the base does not vary after suppressions).
  
To correct all these problems, it is necessary to cleanup the base.
+
To correct all these problems, it is necessary to clean up the base.
  
== With the consang command ==
+
== Cleaning with the consang command ==
 +
A first action can be performed with the {{c|consang}} which will recompute  [[consang]]uinity for the whole base and improves access time. If your base is named {{c|toto}}, the command is:
 +
consang toto
  
A first action can be eprformed with the {{c|consang}} which will recompute  [[consang|consanguinity]] for the whole base and improves access time. If your base is names {{c|toto}}, the command is:
+
The execution speed of this command depends largely on the size of your base. During this process, update possibilities are prohibited. If you try to execute an update through a second window of your browser, which is perfectly accepted in other circumstances, a message will instruct you to try again later.
<pre>consang toto</pre>
+
  
The execution speed of this command depends largly on the size of your base. During this process, updates possibilities are prohibited. If you try to execute an update through a second window of your browser, which is perfectly accepted in other circumstances, a message will instruct you to try again later.
+
You may terminate this process at any time by typing {{keys|Ctrl|C}} in your terminal window. The consanguinity computation will not be finished, but the base will be cleaned up. You may relaunch {{c|consang}} after and the program will resume from its last interruption (unless you have made some family modifications, in which case it will restart from scratch).
  
You may terminate this process at any time by typing {{keys|Ctrl|C}} in your terminal window. The consanguinity computation will not be finished, but the base will be cleaned up. You may relaunch Vous pourrez {{c|consang}} plus tard and the rpogram will resume from its last interruption (unless you have made some family modifications, in which case it will restart from scratch).
+
== Cleaning through saving and restoring a base ==
 +
A deeper clean up can be achieved through a {{c|gwu}} et {{c|gwc}} sequence which recreates a fresh base.
 +
A side benefit of this approach is to produce a source file using the [[GWformat]] which is the preferred archival solution.
 +
In this process, it is recommended to name the new base differently from the old one to avoid problems should any of the steps fail:
 +
gwu toto > toto.gw
 +
then:
 +
gwc toto.gw -o titi
  
== Cleanup through saving and restoring a base ==
+
Note that during this process, any ''isolated'' person (someone not belonging to a family, nor witness or relation to someone else) will disappear from the base. See [[connectivity]] for a deeper discussion about paths between persons and base topology.
  
A deeper cleanup can be achieved through a {{c|gwu}} et {{c|gwc}} sequence which recreates a fresh base.
+
Here, a fresh version of toto is created with the name titi. You can then verify the correctness of titi, and if you are satisfied, you can suppress or archive with a time-stamp {{c|toto.gwb}}, then [[rename]] {{c|titi.gwb}} into {{c|toto.gwb}}.
A side benefit of this approach is to produce a source file using the [[GWformat/GW format]] which is the preferred archival solution.
+
In this process, it is recommended to name the new base differently from the old one to avoid problems should any of the speps fail:
+
<pre>gwu toto > toto.gw</pre>
+
then:
+
<pre>gwc toto.gw -o titi</pre>
+
 
+
Here, a fresh version of toto is created with the name titi. You can then verify the correctness of titi, and if you are satisfied, you can suppress or archive with a time-stamp {{c|toto.gwb}}, pthenuis [[rename|rename]] {{c|titi.gwb}} into {{c|toto.gwb}}.
+
  
 
The execution of gwc produces also a file with extension {{c|.gwo}} which you can suppress, as well as the {{c|.gw}} source files (which you could also [[save/fr|archive]] with the appropriate time-stamp).
 
The execution of gwc produces also a file with extension {{c|.gwo}} which you can suppress, as well as the {{c|.gw}} source files (which you could also [[save/fr|archive]] with the appropriate time-stamp).
Line 35: Line 34:
 
If you want the consanguinity information, you must run {{c|consang}} on the new base.  
 
If you want the consanguinity information, you must run {{c|consang}} on the new base.  
  
[[Category:Manuel]]
+
{{manual}}
 +
 
 +
[[Category:Manual]]

Latest revision as of 13:01, 22 April 2016

150px-Geographylogo svg.png Language: English • français

This article explains how to clean up a GeneWeb database using command lines. This action is also available through the gwsetup interface.

As you progress in the modification of your base, some issues may crop up:

  • After a lot of modifications, response time may increase.
  • If you add or modify families, consanguinity does not appear anymore or is incorrect.
  • If you suppress persons or families, the corresponding space in the base is not reclaimed (the total number of persons in the base does not vary after suppressions).

To correct all these problems, it is necessary to clean up the base.

Cleaning with the consang command

A first action can be performed with the consang which will recompute consanguinity for the whole base and improves access time. If your base is named toto, the command is:

consang toto

The execution speed of this command depends largely on the size of your base. During this process, update possibilities are prohibited. If you try to execute an update through a second window of your browser, which is perfectly accepted in other circumstances, a message will instruct you to try again later.

You may terminate this process at any time by typing Ctrl + C in your terminal window. The consanguinity computation will not be finished, but the base will be cleaned up. You may relaunch consang after and the program will resume from its last interruption (unless you have made some family modifications, in which case it will restart from scratch).

Cleaning through saving and restoring a base

A deeper clean up can be achieved through a gwu et gwc sequence which recreates a fresh base. A side benefit of this approach is to produce a source file using the GWformat which is the preferred archival solution. In this process, it is recommended to name the new base differently from the old one to avoid problems should any of the steps fail:

gwu toto > toto.gw

then:

gwc toto.gw -o titi

Note that during this process, any isolated person (someone not belonging to a family, nor witness or relation to someone else) will disappear from the base. See connectivity for a deeper discussion about paths between persons and base topology.

Here, a fresh version of toto is created with the name titi. You can then verify the correctness of titi, and if you are satisfied, you can suppress or archive with a time-stamp toto.gwb, then rename titi.gwb into toto.gwb.

The execution of gwc produces also a file with extension .gwo which you can suppress, as well as the .gw source files (which you could also archive with the appropriate time-stamp).

If you want the consanguinity information, you must run consang on the new base.


GeneWeb Manual

Rembrandt Old Man Reading a Book.jpg

Use and manage genealogical databases

Technical annex