Short Communication: IPC Salix Cultivar Database Proof-of-Concept
Abstract
:1. Introduction
1.1. Characteristics of the Original IPC Salix Spreadsheet Data
1.2. Characteristics of the Canadian Database Model
- ID: A unique number for each entry. This column may allow duplicate “Name” column entries without conflict.
- Name: The family population name or a clone number or name.
- Family: Population entries display seedlot number. Clone entries display family numbers if known. This column data may associate with other family columns such as “Family comments”, Male and Female parent columns, Male and Female Clone, and “Year Bred” columns.
- Sex: Four single-character designations: M (Male), F (Female), U (Unknown), or B (Both).
- Genus/Material Type: Five two-character designations for the genus or material type.
- Source Type: Multi-character categories describing source types including sib types, cuttings, wild, or NA (Not Available/Not Applicable).
- Category: Multi-character classifications of Populus or Salix germplasm including sib types, cuttings, wild, native, or NA (Not Available/Not Applicable).
- Female and Male Parent Columns: The female or male species name with parentheses used to distinguish between parents in three-species clones.
- Female and Male Parent Clone Columns: The female or male clone name or number used to produce the clone. Parentheses are used to distinguish between parents in three-species clones.
- Year Bred: The four-digit year when the breeding or collection took place or NA (Not Available/Not Applicable).
- Year Selected: The four-digit year when the material was selected or NA (Not Available/Not Applicable).
- Year Released: The four-digit year when the material was released for commercial use or NA (Not Available/Not Applicable).
- Hybrid Designation: Hybrid names are preceded with the Punycode “×” multiplication character to improve database searching. However, caution is urged since the exact hybrid lineage has not been scientifically verified for some of the earlier data. This column lists an applicable hybrid name that may associate with the listed parental species name entries.
- Many column entries only allow specific character set entries using SQL check constraints to help maintain data entry integrity. Examples include the “Sex” (single character), “Category” (variable characters), and “Year selected” (4 digits). Some fields also allow “NA” values that designate “Not Available/Not Applicable” data.
- The Canadian database records have a flat single table appearance similar to a database view making it possible to display them in a single spreadsheet worksheet. This single table view process makes it easier for users to understand and view the data simply using the various search fields to access the entire database. Searching the database is case insensitive and does not require the exact case of the intended values. Below are sample searches that help describe the data:
- Searching the Clone Directory Database [6] for the clone “Name”, “a69” can be entered as, “A69” or “a69” both returning 65 results.
- The aforementioned search returns “AK50” as a “Name” column value without a space, while other “AK” entries have spaces.
- Searching the “Name” fields for “ak” or “AK” both return 39 results including “AK50”.
- Searching the “Name” fields for “ak 30” and the “Female Parent Clone” column for “a69” returns two “AK 30” “Name” records. This is possible because the “ID” fields are different. Also, note that the “Current Status” and “Data Source” values are different and may explain the discrepancy.
- Searching the “Female Parent Clone” column for “473-5070” returns ten records with the “Female Parent Clone” value of: “473-5070; FR17; Fraser River South-BC, Canada”. However, searching the “Name” column for “473-5070” or “FR17” returns no records. The database search tool may not be able to identify parents also included in the “Name” clone column.
1.3. Characteristics of the Open4st Database Model
- Database Tables are displayed on the left side and views on the right. Clicking on a table or a view displays its contents similar to a spreadsheet. Database tables in this context are based on actual spreadsheet data that are loaded into the database.
- Database views can display data from different tables in a variety of reports and summaries with different levels of aggregation.
- Clicking on the view “Count” header displays the count of each view.
- Below are navigation options for the tables or views (Figure 2: Open4st Plant Table Listing):
- ○
- Selecting the “full content” box and clicking the “Search” button expands rows to include all data.
- ○
- Export any given page by clicking one of the “Export to CSV:” options.
- ○
- Click on any column header to reverse the entire column sort order.
- ○
- The user can search any column by entering text in the search box below the “All tables” link, then select the related column from the next drop-down list. Searches are case insensitive.
- The Execute SQL pages allow the user to enter SQL Queries to further refine the search. This is an advanced feature.
1.4. Characteristics of the Integrated IPC Salix Cultivar Database Proof-of-Concept
1.5. Integrated IPC Salix Cultivar Database Use Case
1.5.1. Brief Description
1.5.2. Actors
- IPC Salix Administrator: (e.g., Yulia Kuzovkina).
- IPC Salix User: A user submitting an IPC Salix Checklist request that should be approved by Kuzovkina before it is uploaded to the database.
- Database Administrator (DBA): (e.g., Patrick McGovern).
- Local Database System: Located on the DBA’s local desktop computer with production (PRD) and pre-production (SIT or Staging) database environments.
- Online Database System: Located on an online hosted database server with SIT and PRD database environments.
- Online Salix Checklist Worksheets: The user-accessible Google worksheets with the Online Salix Checklist View data that is documented and formatted to allow users to copy and submit their own root-level epithet and epithet/family level records. See Google worksheets: vw3_checklist_root_level_epithet [16] vw4_checklist_epithet_family [17] and a CollaboratedChecklist [18] for all parties to collaborate on the proposed Checklist entries.
1.5.3. Triggers
1.5.4. Pre-Conditions
- The Local and Online Database Systems have pre-populated table and view data (e.g., Epithet, Family and Pedigree tables, and Checklist views).
- The Online Salix Cultivar Worksheets (vw3_checklist_root_level_epithet [16] and vw4_checklist_epithet_family [17]) have the latest version of the vw3_checklist_root_level_epithet [14] and vw4_checklist_epithet_family [15] data from the Online Database System and are available for IPC Salix user access.
1.5.5. Basic Flow of Events
- The IPC Salix Users download the Google Online Salix Cultivar Worksheet with the vw3_checklist_root_level_epithet and vw4_checklist_epithet_family view data and submit their new root epithet and/or family epithet Salix record request to the IPC Salix Administrator.
- The IPC Salix Administrator reviews the IPC Salix user Cultivar submission and communicates with the user to approve, reject, or adjust the request.
- The approved Cultivar files are entered by the DBA into the SIT Local Database System, which is then copied to the SIT read-only Online Database System viewable by all users.
- The IPC Salix Administrator and user approve, reject, or adjust the SIT changes.
- The approved changes are then promoted by the DBA and copied to the PRD Local and Online read-only Database systems.
1.5.6. Special Requirements
- The complexity of the system may likely require dedicated IT personnel to implement and maintain this process long term.
- Any other system changes are also tested first in SIT, and then promoted to PRD. Version control for database and/or Checklist file updates are considered.
1.6. Technical Information
Author Contributions
Funding
Data Availability Statement
Acknowledgments
Conflicts of Interest
References
- Kuzovkina, Y.A. Checklist for Cultivars of Salix L. (Willow). 2015. Available online: http://www.fao.org/forestry/44983-0370ab0c9786d954da03a15a8dd4721ed.pdf (accessed on 15 January 2021).
- Kuzovkina, Y.A. Compilation of the Checklist for Cultivars of Salix (Willow). Hortic. Sci. 2015, 50, 1608–1609. [Google Scholar] [CrossRef]
- Butterick, M. Straight and Curly Quotes. Available online: https://practicaltypography.com/straight-and-curly-quotes.html (accessed on 15 January 2021).
- Poplar and Willow Council of Canada. Populus and Salix Clone Directory for Canada. 2018. Available online: http://www.poplar.ca/clone-directory (accessed on 15 January 2021).
- Poplar and Willow Council of Canada. Headings and Descriptions for the Poplar & Willow Clone Directory Database. 2018. Available online: http://www.poplar.ca/clone-directory-descriptions (accessed on 15 January 2021).
- Poplar and Willow Council of Canada. Clone Directory Database. 2018. Available online: http://www.poplar.ca/clone-directory-database (accessed on 15 January 2021).
- McGovern, P.N. Using and Accessing the r4st Database. 2020. Available online: https://sites.google.com/site/open4st/faq/what-is-the-open4st-database (accessed on 15 January 2021).
- Open4st. Aspen Trees: A Synergistic Resource. 2010. Available online: https://sites.google.com/site/open4st (accessed on 15 January 2021).
- PostgreSQL. The World's Most Advanced Open Source Relational Database. Available online: https://www.postgresql.org/ (accessed on 15 January 2021).
- Tomczak, C. DBKiss. 2019. Available online: https://github.com/cztomczak/dbkiss (accessed on 18 January 2021).
- McGovern, P.N. GitHub 24dev-Demo. 2020. Available online: https://github.com/pmcgover/24dev-demo (accessed on 18 January 2021).
- OSGEOLive. OSGEOLive. 2011. Available online: https://live.osgeo.org/en/index.html (accessed on 18 January 2021).
- Open Source Initiative. The MIT License. Available online: https://opensource.org/licenses/MIT (accessed on 18 January 2021).
- McGovern, P.N. View vw3_Checklist_Root_Level_Epithet. 2020. Available online: http://pmcgovern.us/ipc/ipcro2.php?viewtable=vw3_checklist_root_level_epithet (accessed on 18 January 2021).
- McGovern, P.N. View Vw4_Checklist_Epithet_Family. 2020. Available online: http://pmcgovern.us/ipc/ipcro2.php?viewtable=vw4_checklist_epithet_family&search=&column=&column_type=&order_by=&full_content=on (accessed on 18 January 2021).
- McGovern, P.N. Worksheet vw3_Checklist_Root_Level_Epithet. 2020. Available online: https://docs.google.com/spreadsheets/d/1z05wOF6q5OFMboB7BdNih5TaAFRM__K0yhNzuq8Tq4U/edit#gid=2137439597 (accessed on 18 January 2021).
- McGovern, P.N. Worksheet vw4_Checklist_epithet_Family. 2020. Available online: https://docs.google.com/spreadsheets/d/1z05wOF6q5OFMboB7BdNih5TaAFRM__K0yhNzuq8Tq4U/edit#gid=76850055 (accessed on 18 January 2021).
- McGovern, P.N. Worksheet CollaboratedChecklist. 2020. Available online: https://docs.google.com/spreadsheets/d/1z05wOF6q5OFMboB7BdNih5TaAFRM__K0yhNzuq8Tq4U/edit#gid=1533711583 (accessed on 18 January 2021).
- VirtualBox. Welcome to VirtualBox.org! Available online: https://www.virtualbox.org (accessed on 18 January 2021).
- McGovern, P.N.; Kuzovkina, Y.A.; Soolanayakanahally, R.Y. Technical Information: IPC Salix Cultivar Database Proof-of-Concept. 2021. Available online: https://sites.google.com/site/open4st/faq/technical-information-ipc-salix-cultivar-database-proof-of-concept (accessed on 28 April 2021).
Publisher’s Note: MDPI stays neutral with regard to jurisdictional claims in published maps and institutional affiliations. |
© 2021 by the authors. Licensee MDPI, Basel, Switzerland. This article is an open access article distributed under the terms and conditions of the Creative Commons Attribution (CC BY) license (https://creativecommons.org/licenses/by/4.0/).
Share and Cite
McGovern, P.N.; Kuzovkina, Y.A.; Soolanayakanahally, R.Y. Short Communication: IPC Salix Cultivar Database Proof-of-Concept. Forests 2021, 12, 631. https://doi.org/10.3390/f12050631
McGovern PN, Kuzovkina YA, Soolanayakanahally RY. Short Communication: IPC Salix Cultivar Database Proof-of-Concept. Forests. 2021; 12(5):631. https://doi.org/10.3390/f12050631
Chicago/Turabian StyleMcGovern, Patrick N., Yulia A. Kuzovkina, and Raju Y. Soolanayakanahally. 2021. "Short Communication: IPC Salix Cultivar Database Proof-of-Concept" Forests 12, no. 5: 631. https://doi.org/10.3390/f12050631
APA StyleMcGovern, P. N., Kuzovkina, Y. A., & Soolanayakanahally, R. Y. (2021). Short Communication: IPC Salix Cultivar Database Proof-of-Concept. Forests, 12(5), 631. https://doi.org/10.3390/f12050631