Merge pull request #4106 from solgenomics/topic/wishlist
[sgn.git] / docs / 03_managing_breeding_data / 03_03.md
blobba8080b486a6185602cc627170755c9f0882f82c
1 ---
2 title: "3.3 Managing Accessions"
3 layout: doc_page
4 ---
5 The “Manage Accession” page provides links for adding new accessions.
6 You can choose to add accessions into the database by either using a List you have created or by uploading an XLS file. Both options will be detailed below.
7 To begin click on the "Add Accessions or Upload Accession Info" link.
9 ![]({{"assets/images/manage_accessions_add_accessions_link.png" | relative_url }})
11 This will open a dialog allowing you to select either "Using Lists" or "Uploading a File".
13 3.3.1 Add Accessions Using A List
14 ---
16 First we will show how to add accessions "Using Lists".
18 ![]({{"assets/images/manage_accessions_add_accessions_using_lists.png" | relative_url }})
20 Here you select an accession list which you have previously made. If you need to create or edit your list you can do so now by clicking "Manage Lists".
21 Once you have selected your list you can click "Continue".
23 The first dialog which can appear will show the accessions which already exist in the database.
25 ![]({{"assets/images/manage_accessions_add_accessions_found.png" | relative_url }})
27 Click "Continue". The next dialog which can appear will show accessions which have very similar matches to the accession names you are adding.
28 In the example below, there are two accession names that are very similar to accession names already in the database. 'TME0419' is very similar to 'TME419', and actually is probably a mistake that should not be added to the database.
30 ![]({{"assets/images/manage_accessions_add_accessions_fuzzy.png" | relative_url }})
32 To avoid situations in adding a mistaken duplicate accession, the database gives you options for moving forward with these very similar looking accession names. You can either "continue saving the name in your list", "replace name in your list with selected existing name", "remove name in your list and ignore", or "add name in your list as a synonym to selected existing name".
34 ![]({{"assets/images/manage_accessions_add_accessions_fuzzy_options.png" | relative_url }})
36 Clicking "Download Fuzzy Matches" will return a tabular result of the "fuzzy" accession name results shown.
37 Click "Make changes and continue" to move on.
39 The final dialog shows the accessions that will be added. Here you need to assign the species of these accessions. You can optionally group the accessions into a population and/or add an organization for the accessions.
41 ![]({{"assets/images/manage_accessions_add_accessions_complete_using_list.png" | relative_url }})
43 Once you click "Add Accessions", the new accessions will be created in the database and you will see the following confirmation dialog, which includes links to the newly created accessions.
45 ![]({{"assets/images/manage_accessions_add_accessions_saved.png" | relative_url }})
47 3.3.2 Uploading Accessions and Accession's Info From A File
48 ---
50 The process to upload accessions is very similar to using a list, but enables you to add a variety of properties, such as synonyms, to the accessions in bulk.
52 ![]({{"assets/images/manage_accessions_add_accessions_using_file.png" | relative_url }})
54 Clicking on "Spreadsheet format" will show the following dialog.
55 Here it shows that the file must be XLS format and can contain a number of header columns as attributes. It is important that you use exactly the same header column names as listed here. In columns that indicate that many attribute values can be passed at once using (s), such as synonym(s), you can pass a comma separated list of values, such as 'synonym1,synonym2'.
57 ![]({{"assets/images/manage_accessions_add_accessions_spreadsheet_info.png" | relative_url }})
59 Once you have selected your XLS file for upload, click "Continue".
61 The following process is the same way as with lists:
63 The first dialog which can appear will show accession names which are already in the database.
65 Click "Continue" and the next dialog that can appear will show "fuzzy" matches for the accession names you are trying to upload. Here you can choose to prevent adding accession names which look very similar to each other as wrongly duplicated accessions.
67 Click "Continue" and the final dialog that will appear will show the information to be added into the database. Here it is divided into accession names that are new and accession names that already exist in the database; however, for the accession names that already exist it will show additional attributes that originated from your file that will be added to these accessions.
69 ![]({{"assets/images/manage_accessions_add_accessions_complete_using_file.png" | relative_url }})
71 Once you click "Add Accessions", the new accessions and information will be created in the database and you will see the following confirmation dialog, which includes links to the created and updated accessions.
73 ![]({{"assets/images/manage_accessions_add_accessions_saved.png" | relative_url }})
76 3.3.3 Add Parentage (Pedigree) Information to Accessions
77 ---
79 You can upload pedigree file from your computer to the database by clicking on “Upload Pedigree File”
81 ![]({{"assets/images/image286.png" | relative_url }})
83 ***IMPORTANT!* Please use only tab-delimited text file format (.xls or .xlsx formats are NOT supported).**
85 You can find detailed information on how to prepare pedigree file by clicking on “File format information”
87 ![]({{"assets/images/image333.png" | relative_url }})
88 ![]({{"assets/images/pedigree_upload_format.png" | relative_url }})