+
-
- Data Standards for Soil- and Agricultural Research
-
-
-Authors: Carsten Hoffmann, Sina Schulz, Einar Eberhardt, Meike Grosse, Susanne Stein, Xenia Specka, Nikolai Svoboda,
-Uwe Heinrich
-This living document has been produced in the framework of the German research
-initiative BonaRes (Soil as a sustainable resource for the bio-economy). The third
-version is published in the BonaRes Series, 2020 with more than 600 standards,
-as relevant for the soil- and agricultural research data management. As the report is a living document, the report is
-transferred to this web application to compile, discuss and recommend the latest state of data standards for
-soil and agricultural research.
-
-
-
- Motivation
-
-
-The use of open and widely accepted standards is the basis for modern (FAIR, [1]) research data management. In this context, task of
-this report is to describe, compare, review and recommend standards for the whole data life and to assist soil- and
-agricultural scientists to store their research data into a data infrastructure to make them findable and accessible in
-the long-term for any reuse. Missing and competitive national and international standards and potential conflicts are
-stated and, based on internal and external expert knowledge, outstanding standards are highlighted and summarized to
-recommendations:
-
-
-
-
-
-
Recommendation explanation
-
Favored = highly recommended for application
- OK = acceptable alternative but maybe requires later transformation
-
-
-
-In the Appendix the highly recommended standards as well as many code lists, glossaries and web
-links are listed in tables
-
-
The BonaRes Repository
-
+
-In July 2017, the BonaRes Centre launched
-the BonaRes Repository for soil and
-agricultural research data. Beside data from national research projects, the repository is open for other soil-related
-data, e.g. from agricultural long-term field experiments (LTE). The BonaRes Centre provides DOI, easy access and
-long-term availability for all uploaded research data. According to
-the Berlin Declaration on Open Access (2003)[2] and the initiative
-“Digitale Information”[3] , metadata and research data will not be subject to any restrictions
-on reuse. Metadata are always available and, after a limited embargo-time, also research data are provided accessible
-for the international research community. Further information is given in the BonaRes Data
-Guideline [4].
+In the BonaRes Repository, digital research data of soil and agricultural sciences are published and made reusable for scientists and interested parties. This manual is primarily aimed at beginners and is a step-by-step tutorial based on a simple use case. If you have any questions or further needs regarding research data management do not hesitate to contact our data stewards team: support-data@bonares.de.
+The original version of this documentation is available in the BonaRes Series while the basic rules were described in the BonaRes data policy.
-According to the GitHub FAIRMetrics,
-the BonaRes Repository serves all relevant
-elements of FAIR data principles (Findable, Accessible, Interoperable, Reusable, see [1]), and
-additionally, provides legal security for sensitive data and facilitate data up- and downloads. To meet these demands
-and to enhance research data reusability (FAIR Principle R 1.3)[1], the use of relevant open community standards and data
-documentation during data life is necessary. Such standards concern, beside others, the classification and description
-of soils, field- and lab methods, agricultural technology, plant varieties, fertilizers, farming and agricultural
-business, data quality control, ontologies, data formats, data storage and -archiving, and metadata management. All
-standards which are recommended within this document are supported by the BonaRes repository. Research data which were
-collected under standardized conditions, described with coherent metadata, proofed by quality tests, and stored in the
-repository, will be visible, accessible and citable for any data reuse (e.g. modelling), exchange or review.
-In the long term it is planned to consolidate the BonaRes Repository into international infrastructures for soil and
-agricultural research data. This requires data interoperability by internationally accepted and applied standards.
-Transformation tools may help to translate data from national to international valid systems and formats.
-
+Tips & Tricks: https://doi.org/10.20387/bonares-mvkn-a4mb
+
Policy: https://doi.org/https://doi.org/10.20387/BonaRes-RYCV-30RK
diff --git a/resources/js/config.js b/resources/js/config.js
index 843064c..38d8853 100644
--- a/resources/js/config.js
+++ b/resources/js/config.js
@@ -1 +1 @@
-var __DOCS_CONFIG__ = {"id":"z0IItIF6255WLfj+7XXsiY/3V2kOZaKjNt/","key":"U1wpX9oFCrsaAkXidM6PUZkkvBltiT+DOkBQgIdWsKg.sPuOpf//5zMimb5WlbEHRIWyppuVJTVYJ33UzWdRZutoU1VLNRQ6iwUfXOVMyHgl5HY71LwMNFA/GHeFCbG3bg.67","base":"/","host":"bonares-handbook","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.5.0.761925567090","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"Home","s":""},{"n":"datapreparation","l":"Data Preparation","s":""},{"n":"how_to_publish","l":"How to Publish","i":[{"n":"registration","l":"Registration","s":""},{"n":"download_and_fill_out","l":"Download and fill out the metadata Template","s":""},{"n":"dataset_and_metadata","l":"Dataset and Metadata Submission","s":""}],"s":""},{"n":"submission_details","l":"Submission Details","s":""},{"n":"faq","l":"FAQ","s":""},{"n":"contact","l":"Contact","s":""}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["/"],"noResultsFoundMsg":"No results","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}};
+var __DOCS_CONFIG__ = {"id":"oiUJ4wVA255zvkhRcenip0luDfKrHw0rzGX","key":"kdati3R0sd0yL4CLVY7uCp+ZU2gX1qzp7pu0cONyO+k.OHmwEfoxQ3+B407/tRIDXWe4KhvafrU64vHL/cmf566XRCQJIJ73HO9Xszg07l7ueSdvUZ0be9y+63rjXLrLUA.61","base":"/","host":"bonares-handbook","version":"1.0.0","useRelativePaths":true,"documentName":"index.html","appendDocumentName":false,"trailingSlash":true,"preloadSearch":false,"cacheBustingToken":"3.5.0.767086891965","cacheBustingStrategy":"query","sidebarFilterPlaceholder":"Filter","toolbarFilterPlaceholder":"Filter","showSidebarFilter":true,"filterNotFoundMsg":"No member names found containing the query \"{query}\"","maxHistoryItems":15,"homeIcon":"","access":[{"value":"public","label":"Public"},{"value":"protected","label":"Protected"}],"toolbarLinks":[{"id":"fields","label":"Fields"},{"id":"properties","label":"Properties"},{"id":"methods","label":"Methods"},{"id":"events","label":"Events"}],"sidebar":[{"n":"/","l":"Home","s":""},{"n":"datapreparation","l":"Data Preparation","s":""},{"n":"how_to_publish","l":"How to Publish","i":[{"n":"registration","l":"Registration","s":""},{"n":"download_and_fill_out","l":"Download and fill out the metadata Template","s":""},{"n":"dataset_and_metadata","l":"Dataset and Metadata Submission","s":""}],"s":""},{"n":"submission_details","l":"Submission Details","s":""},{"n":"faq","l":"FAQ","s":""},{"n":"contact","l":"Contact","s":""}],"search":{"mode":0,"minChars":2,"maxResults":20,"placeholder":"Search","hotkeys":["/"],"noResultsFoundMsg":"No results","recognizeLanguages":true,"languages":[0],"preload":false},"resources":{"History_Title_Label":"History","History_ClearLink_Label":"Clear","History_NoHistory_Label":"No history items","API_AccessFilter_Label":"Access","API_ParameterSection_Label":"PARAMETERS","API_SignatureSection_Label":"SIGNATURE","API_CopyHint_Label":"Copy","API_CopyNameHint_Label":"Copy name","API_CopyLinkHint_Label":"Copy link","API_CopiedAckHint_Label":"Copied!","API_MoreOverloads_Label":"more","API_MoreDropdownItems_Label":"More","API_OptionalParameter_Label":"optional","API_DefaultParameterValue_Label":"Default value","API_InheritedFilter_Label":"Inherited","Search_Input_Placeholder":"Search","Toc_Contents_Label":"Contents","Toc_RelatedClasses_Label":"Related Classes","History_JustNowTime_Label":"just now","History_AgoTime_Label":"ago","History_YearTime_Label":"y","History_MonthTime_Label":"mo","History_DayTime_Label":"d","History_HourTime_Label":"h","History_MinuteTime_Label":"m","History_SecondTime_Label":"s"}};
diff --git a/resources/js/search.json b/resources/js/search.json
index dfd4db0..04f214d 100644
--- a/resources/js/search.json
+++ b/resources/js/search.json
@@ -1 +1 @@
-[[{"i":"data-standards-for-soil--and-agricultural-research","l":"Data Standards for Soil- and Agricultural Research","p":["Authors: Carsten Hoffmann, Sina Schulz, Einar Eberhardt, Meike Grosse, Susanne Stein, Xenia Specka, Nikolai Svoboda, Uwe Heinrich","This living document has been produced in the framework of the German research initiative BonaRes(Soil as a sustainable resource for the bio-economy). The third version is published in the BonaRes Series, 2020 with more than 600 standards, as relevant for the soil- and agricultural research data management. As the report is a living document, the report is transferred to this web application to compile, discuss and recommend the latest state of data standards for soil and agricultural research."]},{"l":"Motivation","p":["The use of open and widely accepted standards is the basis for modern (FAIR, [1]) research data management. In this context, task of this report is to describe, compare, review and recommend standards for the whole data life and to assist soil- and agricultural scientists to store their research data into a data infrastructure to make them findable and accessible in the long-term for any reuse. Missing and competitive national and international standards and potential conflicts are stated and, based on internal and external expert knowledge, outstanding standards are highlighted and summarized to recommendations:","Favored = highly recommended for application OK = acceptable alternative but maybe requires later transformation","In the Appendix the highly recommended standards as well as many code lists, glossaries and web links are listed in tables"]},{"l":"The BonaRes Repository","p":["In July 2017, the BonaRes Centre launched the BonaRes Repository for soil and agricultural research data. Beside data from national research projects, the repository is open for other soil-related data, e.g. from agricultural long-term field experiments (LTE). The BonaRes Centre provides DOI, easy access and long-term availability for all uploaded research data. According to the Berlin Declaration on Open Access (2003)[2] and the initiative“Digitale Information”[3], metadata and research data will not be subject to any restrictions on reuse. Metadata are always available and, after a limited embargo-time, also research data are provided accessible for the international research community. Further information is given in the BonaRes Data Guideline [4].","According to the GitHub FAIRMetrics, the BonaRes Repository serves all relevant elements of FAIR data principles (Findable, Accessible, Interoperable, Reusable, see [1]), and additionally, provides legal security for sensitive data and facilitate data up- and downloads. To meet these demands and to enhance research data reusability (FAIR Principle R 1.3)[1], the use of relevant open community standards and data documentation during data life is necessary. Such standards concern, beside others, the classification and description of soils, field- and lab methods, agricultural technology, plant varieties, fertilizers, farming and agricultural business, data quality control, ontologies, data formats, data storage and -archiving, and metadata management. All standards which are recommended within this document are supported by the BonaRes repository. Research data which were collected under standardized conditions, described with coherent metadata, proofed by quality tests, and stored in the repository, will be visible, accessible and citable for any data reuse (e.g. modelling), exchange or review.","In the long term it is planned to consolidate the BonaRes Repository into international infrastructures for soil and agricultural research data. This requires data interoperability by internationally accepted and applied standards. Transformation tools may help to translate data from national to international valid systems and formats.","[1] Wilkinson, M., Dumontier, M., Aalbersberg, I. et al. The FAIR Guiding Principles for scientific data management and stewardship. Sci Data 3, 160018 (2016). DOI: 10.1038/sdata.2016.18","[2] Berlin Declaration on Open Access (2003). https://openaccess.mpg.de/Berliner-Erklaerung.","[3] Alliance of Science Organizations in Germany (2013). http://www.allianzinitiative.de/en/.","[4] Svoboda, N. and U. Heinrich (2017). The BonaRes Data Guideline. BonaRes Data Centre. http://doi.org/10.20387/BonaRes-E1AZ-ETD7."]}],[{"l":"Data Preparation","p":["A dataset summarizes research data on a delimited situation in a structured manner. The research data should be prepared in such a way that easy reuse is possible. In principle, the data record should be tabular and column-based. In most cases, soil and agricultural data have a spatial reference. The spatial position of the measuring points or areas should be given in the table as detailed as possible.","A typical dataset for data transfer to the BonaRes Data Centre has the following properties:","Each column (attribute) of the table contains the attribute name in the first row and the attribute values in the following rows, which means the data within the table are column-oriented. Each table or dataset must be given a short, concise name. For widespread reuse, work should be done in English if possible.","Typically, each table contains the following standard attributes:","Table 1: Example table with typical standard attributes of a data table"]},{"i":"the-following-formal-criteria-must-be-met","l":"The following formal criteria must be met:","p":["... do not contain separators such as “;” (decimal numbers are uniformly written with “.” or “,” and differ from column delimiter)","... do not start with a number","...are a maximum of 30 characters long","...are only assigned once","Attribute names contain no spaces(an underscore „_“ is allowed to use), special characters, umlauts, “ß” or units","Cells are not connected","Cells contain no spaces","Column delimiter is consistent and clearly identifies throughout the table (e. g. ”;” or “,”)","Datasets submitted in file formats, which can be integrated to the SQL database of the BonaRes Data Centre is made available with full service (options for file formats and coordinate system, description of the data model, ...). Other research data e.g., Pictures, videos or comparable formats can be downloaded by the re-user in the file format as submitted. If you have any questions, contact the support of BonaRes Repository","Each column contains a unique attribute name (between upper and lower case not differentiated z. B. “beetles” and “Beetles”)","Each line is available once(there are no double lines e. g. due to copy errors)","IDs are only assigned once","In case of multiple sheets, upload each sheet as a separate table","Missing values are explicitly marked and clearly differ from “none specification \"and\" 0 \"","Only one value specified per cell","Tables are unformatted (do not contain grafical elements, colored lines, …)","Tables contain only one worksheet (avoid Excel folders with multiple sheets)","The prepared dataset should be submitted in the file format txt, csv, xls or xslx. Avoid file formats that cannot be read with common programs. For example, formats for special company software for data loggers. In addition to tables, the BonaRes Repository also publishes all formats of research data that are common in science, such as pictures, videos, texts. The BonaRes Centre also is able to deal with complex file structures (Access, SQL, Shape, ...). In this case contact the support of BonaRes Repository.","There are no internal references or formulas within a table |","Values in the cells contain no units, explanations or abbreviations e. g. \"Under detection limit” or “< 0.00 ”","Values within a column are constant ( no change of reference variable or unit)"]}],[{"l":"How to publish a dataset in the BonaRes Repository","p":["Registration on BonaRes Repository","Download and fill the Metadata Template","Dataset and Metadata Submission"]}],[{"l":"Registration on BonaRes Repository","p":["A one-time registration is required to use the services of the BonaRes Centre e. g., the upload tool"]},{"i":"1-specification-of-user-name-and-email-address-as-well-as-assignment-of-a-password","l":"1. Specification of user name and email address, as well as assignment of a password","p":["The following conditions must be met for the password:","it must consist of at least 8 characters","it must contain at least 3 small letters","it must differ from the user name and email address","it must contain at least 3 character classes (e.g. uppercase, lowercase, special characters, numbers)"]},{"l":"2.Signup","p":["Data upload tool"]},{"i":"3-receive-a-confirmation-email-from-the-bonares-repository-double-opt-in","l":"3. Receive a confirmation email from the BonaRes Repository (double opt in)"},{"l":"4. Confirm the registration by clicking the link in the email","p":["If the intention is to submit several datasets of a research group, it is possible to organize all of the associated data providers in one project in the BonaRes Centre. In this case, the BonaRes Centre should be contacted BEFORE registration, so the project can be created in advance. The same project affiliation allows you to search for specific project data. Pre-entries about shared templates within the project save time and effort when describing the metadata. The rights for editing the metadata are distributed in a targeted manner."]}],[{"l":"Download and fill out the metadata Template","p":["If data are already published in another open repository, the BonaRes Centre offers to take over the metadata of the dataset and to disseminate it via its own infrastructure. There is a link to the location of the dataset. This means that the research data can also be found via the BonaRes Repository without the need for republication. Contact the support of the BonaRes Repository here: support-data@bonares.de."]},{"l":"Download","p":["Download the metadata template here"]},{"l":"How to Fill out the Metadata Template","p":["Author(s): Include an ORCID","Contributor: click on “choose an element” and select an option.","Dataset details: describe what each column stands for and precise the units and methods if applicable","Embargo: refers to a period (max 24 months) during which the data cannot be downloaded.","For large datasets use extra excel file. See below. Image/grapic: provide an image that represents your dataset","Funding information: provide cross ref links if available.","Geographic area: provide bounding box information from where the data was collected.","Keywords: click on links and select keywords then write them under each link.","Metadata template: example of excel file for simple data sets","Metadata template: page 1","Metadata template: page2","Metadata template: page3","Place keywords: precise location","Related data already published: click on “choose an element” and select an option of the Relation Type.","Summary English: Maximum of xxxxxx characters","Summary German: Maximum of xxxxx characters","Title English: Max of xxxxx characters","Title German: Max of xxxx characters"]}],[{"l":"Dataset and Metadata Submission"},{"l":"Submit a new dataset","p":["After completing the metadata template, click on the “submit new dataset” button and fill the upload form."]},{"l":"Filling out the Upload form","p":["The first step in the upload form is to provide a title and a brief but understandable description of the dataset – analogue to the abstract of a paper but specified to this data. This information is the basis of the metadata.","Upload form: Title and description of the dataset"]},{"i":"upload-form-selection-of-project","l":"Upload form: Selection of Project","p":["The project in which the data were collected must be specified in the following field. You can choose from the BonaRes collaborative projects and some long-term field experiments. For all other data that cannot be assigned to any of these projects, “Other” must be specified. In the future, it should also be possible to manually enter the individual projects.","Upload form: Project"]},{"i":"upload-form-selection-of-the-relevant-research-domain","l":"Upload form: Selection of the relevant Research Domain","p":["When selecting the research domain, the most appropriate domain should be selected. Only one domain can be selected. The research domains are based on the categories of the German Research Foundation (DFG)(FK No. 207 Agriculture, Forestry and Veterinary Medicine)."]},{"i":"upload-form-specifying-the-research-question","l":"Upload form: Specifying the research question","p":["Now the research question for which the available data were determined can be specified. Of course, there are not \"the\" good and \"the\" bad data - but data are of high quality in relation to the research question they are supposed to answer. This enables the potential reuser to better assess the suitability of the data for her research.","Fields with two lines in the lower right corner can be enlarged if necessary.","If possible, one or more soil functions that match the dataset should be selected that address the underlying study.","Upload form: Selection the soil functions"]},{"i":"upload-form-upload-dataset-metadata-and-supplemental-material","l":"Upload form: Upload dataset, metadata and supplemental material","p":["In the next step, the dataset, metadata, any additional material, such as pictures, plans or drawings, can be uploaded. Please upload just the actual dataset (only one table, one dataset, one worksheet). Multiple worksheets should be split and uploaded separately. To illustrate the research data, you can use a data model that shows the data, e.g. a diagram.","__","Afterwards, additional information can be given specifically for the BonaRes Centre. In addition, the BonaRes data guideline must be approved and assured that the authority exists to hand over the data to the repository and that it has not yet been published elsewhere. This means that the data owner does not necessarily have to submit the data himself and can also designate someone else as the data provider.","If all fields have been filled in, the dataset can be transferred to the BonaRes Centre by clicking on “Submit”. The BonaRes Centre sends an automatic confirmation email afterwards with a ticket number."]},{"i":"upload-form-specification-of-additional-information-consent-to-the-data-guideline-and-confirmation-of-the-authorization-and-the-first-publication","l":"Upload form: Specification of additional information, consent to the data guideline and confirmation of the authorization and the first publication","p":["Additional Information","If the upload was successful, a summary of the submitted information appears. The processing status can also be viewed on this page. As long as the submitted data are formally checked"]}],[{"l":"Submission Details","p":["List of all records","(Status: Submitted), it is possible to make changes. As soon as the data have been added to the database and the metadata have been sent(Status: in progress), contact must be made with the BonaRes Centre for subsequent changes.","The history gives an overview of the completed processing steps of the respective dataset.","An overview of all datasets submitted so far appears in the user account under “Submission” under “My dataset submissions”. If you have any questions or problems, the ticket number should always be given.","After a dataset has been transferred to the BonaRes Centre, it is checked formally and in terms of content (e. g. thematically fit into the BonaRes Repository) by data stewards. Formal checks are, e. g. empty columns, outliers or not plausible values. Conspicuous data are communicated back to the data provider. In the future, the test should carried out by an automated tool. After a dataset passed this formal check, further metadata will be prepared (see chapter Metadata), which can be downloaded as PDF."]}],[{"l":"Frequently Asked Questions"},{"i":"can-i-upload-an-excel-table-with-multiple-sheets","l":":heavy_check_mark: _Can I upload an excel table with multiple sheets?_","p":["No. Each excel sheet should be uploaded separately. However, if the datasets are related, you have to fill the metadata template just once."]},{"i":"how-long-does-it-take-to-obtain-the-doi","l":":heavy_check_mark: How long does it take to obtain the DOI?","p":["With complete metadata it takes normally 2-3 business days depending on the work load"]},{"i":"what-is-an-embargo","l":":heavy_check_mark: What is an embargo?","p":["Embargo refers to a period during which the data cannot be downloaded."]},{"i":"can-i-get-an-inactive-doi-during-the-embargo-period","l":":heavy_check_mark: _Can I get an inactive DOI during the embargo period?_","p":["No. Only active DOI are sent to the authors."]},{"i":"what-is-the-maximum-period-of-embargo","l":":heavy_check_mark: _What is the maximum period of embargo?_","p":["24 Months. However, the less the period the better."]},{"i":"what-if-i-made-a-mistake-and-need-to-correct-it-after-i-received-my-doi","l":":heavy_check_mark: _What if I made a mistake and need to correct it after I received my DOI?_","p":["Metadata can be edited by the data stewards but the dataset cannot be changed. Contact the support team and they will help you."]},{"i":"which-languages-can-i-use-in-my-datasets-columns-and-description","l":":heavy_check_mark: _Which languages can I use in my datasets columns and description?_","p":["English"]},{"i":"for-how-long-will-my-datasets-be-hosted","l":":heavy_check_mark: _For how long will my datasets be hosted?_","p":["More than 10 years"]},{"i":"under-which-license-are-data-and-metadata-made-available-to-reusers","l":":heavy_check_mark: _Under which license are data and metadata made available to reusers?_","p":["Data is available under the cc BY4.0 license","Metadata is available under cc0 license"]},{"i":"in-what-format-should-the-dataset-be-uploaded","l":":heavy_check_mark: _In what format should the dataset be uploaded?_","p":["Only upload files of property 'txt', 'csv', 'xls', 'xslx', 'zip', 'docx', 'jpg', 'pdf', 'shp', 'tif', 'tiff', 'png', 'gif'and with a size smaller than 30 MB."]},{"i":"can-i-upload-datasets-bigger-than-30-mb","l":":heavy_check_mark: _Can I upload datasets bigger than 30 MB?_","p":["No. However, you can contact the support team and they will help you."]},{"i":"where-can-i-find-an-overview-about-the-status-of-my-data-submissions","l":":heavy_check_mark: _Where can I find an overview about the status of my data submissions?_","p":["Login to the upload tool and check under ‘My submissions’ in the upper right section."]},{"i":"is-there-any-fee-associated-with-data-publishing-in-the-bonares-repository","l":":heavy_check_mark: _Is there any fee associated with data publishing in the BonaRes Repository?_","p":["No"]},{"i":"how-will-my-dataset-be-cited","l":":heavy_check_mark: _How will my dataset be cited?_","p":["Once the dataset is published, you can copy the citation in the ‘access’ section of the metadata."]},{"i":"can-i-link-a-paper-or-other-publication-to-my-dataset","l":":heavy_check_mark: _Can I link a paper or other publication to my dataset?_","p":["Yes. Upload all related works and specify in the metadata template how they are related to the dataset to be published."]},{"i":"who-can-be-considered-an-author-of-a-dataset","l":":heavy_check_mark: _Who can be considered an author of a dataset?_","p":["An author can be a student, scientist, technician, or any other individual provided they contributed to the collection and processing of data.","Note that data authors can be different from the authors of the paper that was published based on the data.","To determine who an author is, please follow principles of good scientific practice (refer to the BonaRes Data Guideline in the upload tool)."]}],[{"l":"Frequently Asked Questions"},{"l":"BonaRes Repository","p":["Leibniz Centre for Agricultural Landscape Research (ZALF) Eberswalder Strasse 84 15374 Müncheberg, Germany (+49) 033432 82 300 dataservice@zalf.de https://www.bonares.de/research-data"]}]]
\ No newline at end of file
+[[{"l":"The BonaRes Repository","p":["In the BonaRes Repository, digital research data of soil and agricultural sciences are published and made reusable for scientists and interested parties. This manual is primarily aimed at beginners and is a step-by-step tutorial based on a simple use case. If you have any questions or further needs regarding research data management do not hesitate to contact our data stewards team: support-data@bonares.de.","The original version of this documentation is available in the BonaRes Series while the basic rules were described in the BonaRes data policy.","Tips & Tricks: https://doi.org/10.20387/bonares-mvkn-a4mb Policy: https://doi.org/https://doi.org/10.20387/BonaRes-RYCV-30RK"]}],[{"l":"Data Preparation","p":["A dataset summarizes research data on a delimited situation in a structured manner. The research data should be prepared in such a way that easy reuse is possible. In principle, the data record should be tabular and column-based. In most cases, soil and agricultural data have a spatial reference. The spatial position of the measuring points or areas should be given in the table as detailed as possible.","A typical dataset for data transfer to the BonaRes Data Centre has the following properties:","Each column (attribute) of the table contains the attribute name in the first row and the attribute values in the following rows, which means the data within the table are column-oriented. Each table or dataset must be given a short, concise name. For widespread reuse, work should be done in English if possible.","Typically, each table contains the following standard attributes:","Table 1: Example table with typical standard attributes of a data table"]},{"i":"the-following-formal-criteria-must-be-met","l":"The following formal criteria must be met:","p":["... do not contain separators such as “;” (decimal numbers are uniformly written with “.” or “,” and differ from column delimiter)","... do not start with a number","...are a maximum of 30 characters long","...are only assigned once","Attribute names contain no spaces(an underscore „_“ is allowed to use), special characters, umlauts, “ß” or units","Cells are not connected","Cells contain no spaces","Column delimiter is consistent and clearly identifies throughout the table (e. g. ”;” or “,”)","Each column contains a unique attribute name (between upper and lower case not differentiated z. B. “beetles” and “Beetles”)","Each line is available once(there are no double lines e. g. due to copy errors)","IDs are only assigned once","In case of multiple sheets, upload each sheet as a separate table","Missing values are explicitly marked and clearly differ from “none specification \"and\" 0 \"","Only one value specified per cell","Tables are unformatted (do not contain grafical elements, colored lines, …)","Tables contain only one worksheet (avoid Excel folders with multiple sheets)","The prepared dataset should be submitted in the file format txt, csv, xls or xslx. Avoid file formats that cannot be read with common programs. For example, formats for special company software for data loggers. In addition to tables, the BonaRes Repository also publishes all formats of research data that are common in science, such as pictures, videos, texts. The BonaRes Centre also is able to deal with complex file structures (Access, SQL, Shape, ...). In this case contact the support of BonaRes Repository.","There are no internal references or formulas within a table |","Values in the cells contain no units, explanations or abbreviations e. g. \"Under detection limit” or “< 0.00 ”","Values within a column are constant ( no change of reference variable or unit)"]}],[{"l":"How to publish a dataset in the BonaRes Repository","p":["Registration on BonaRes Repository","Download and fill the Metadata Template","Dataset and Metadata Submission"]}],[{"l":"Registration on BonaRes Repository","p":["A one-time registration is required to use the services of the BonaRes Centre e. g., the upload tool"]},{"i":"1-specification-of-user-name-and-email-address-as-well-as-assignment-of-a-password","l":"1. Specification of user name and email address, as well as assignment of a password","p":["The following conditions must be met for the password:","it must consist of at least 8 characters","it must contain at least 3 small letters","it must differ from the user name and email address","it must contain at least 3 character classes (e.g. uppercase, lowercase, special characters, numbers)"]},{"l":"2.Signup","p":["Data upload tool"]},{"i":"3-receive-a-confirmation-email-from-the-bonares-repository-double-opt-in","l":"3. Receive a confirmation email from the BonaRes Repository (double opt in)"},{"l":"4. Confirm the registration by clicking the link in the email","p":["If the intention is to submit several datasets of a research group, it is possible to organize all of the associated data providers in one project in the BonaRes Centre. In this case, the BonaRes Centre should be contacted BEFORE registration, so the project can be created in advance. The same project affiliation allows you to search for specific project data. Pre-entries about shared templates within the project save time and effort when describing the metadata. The rights for editing the metadata are distributed in a targeted manner."]}],[{"l":"Download and fill out the metadata Template","p":["If data are already published in another open repository, the BonaRes Centre offers to take over the metadata of the dataset and to disseminate it via its own infrastructure. There is a link to the location of the dataset. This means that the research data can also be found via the BonaRes Repository without the need for republication. Contact the support of the BonaRes Repository here: support-data@bonares.de."]},{"l":"Download","p":["Download the metadata template here"]},{"l":"How to Fill out the Metadata Template","p":["Author(s): Include an ORCID","Contributor: click on “choose an element” and select an option.","Dataset details: describe what each column stands for and precise the units and methods if applicable","Embargo: refers to a period (max 24 months) during which the data cannot be downloaded.","For large datasets use extra excel file. See below. Image/grapic: provide an image that represents your dataset","Funding information: provide cross ref links if available.","Geographic area: provide bounding box information from where the data was collected.","Keywords: click on links and select keywords then write them under each link.","Metadata template: example of excel file for simple data sets","Metadata template: page 1","Metadata template: page2","Metadata template: page3","Place keywords: precise location","Related data already published: click on “choose an element” and select an option of the Relation Type.","Summary English: Maximum of xxxxxx characters","Summary German: Maximum of xxxxx characters","Title English: Max of xxxxx characters","Title German: Max of xxxx characters"]}],[{"l":"Dataset and Metadata Submission"},{"l":"Submit a new dataset","p":["After completing the metadata template, click on the “submit new dataset” button and fill the upload form."]},{"l":"Filling out the Upload form","p":["The first step in the upload form is to provide a title and a brief but understandable description of the dataset – analogue to the abstract of a paper but specified to this data. This information is the basis of the metadata.","Upload form: Title and description of the dataset"]},{"i":"upload-form-selection-of-project","l":"Upload form: Selection of Project","p":["The project in which the data were collected must be specified in the following field. You can choose from the BonaRes collaborative projects and some long-term field experiments. For all other data that cannot be assigned to any of these projects, “Other” must be specified. In the future, it should also be possible to manually enter the individual projects.","Upload form: Project"]},{"i":"upload-form-selection-of-the-relevant-research-domain","l":"Upload form: Selection of the relevant Research Domain","p":["When selecting the research domain, the most appropriate domain should be selected. Only one domain can be selected. The research domains are based on the categories of the German Research Foundation (DFG)(FK No. 207 Agriculture, Forestry and Veterinary Medicine)."]},{"i":"upload-form-specifying-the-research-question","l":"Upload form: Specifying the research question","p":["Now the research question for which the available data were determined can be specified. Of course, there are not \"the\" good and \"the\" bad data - but data are of high quality in relation to the research question they are supposed to answer. This enables the potential reuser to better assess the suitability of the data for her research.","Fields with two lines in the lower right corner can be enlarged if necessary.","If possible, one or more soil functions that match the dataset should be selected that address the underlying study.","Upload form: Selection the soil functions"]},{"i":"upload-form-upload-dataset-metadata-and-supplemental-material","l":"Upload form: Upload dataset, metadata and supplemental material","p":["In the next step, the dataset, metadata, any additional material, such as pictures, plans or drawings, can be uploaded. Please upload just the actual dataset (only one table, one dataset, one worksheet). Multiple worksheets should be split and uploaded separately. To illustrate the research data, you can use a data model that shows the data, e.g. a diagram.","__","Afterwards, additional information can be given specifically for the BonaRes Centre. In addition, the BonaRes data guideline must be approved and assured that the authority exists to hand over the data to the repository and that it has not yet been published elsewhere. This means that the data owner does not necessarily have to submit the data himself and can also designate someone else as the data provider.","If all fields have been filled in, the dataset can be transferred to the BonaRes Centre by clicking on “Submit”. The BonaRes Centre sends an automatic confirmation email afterwards with a ticket number."]},{"i":"upload-form-specification-of-additional-information-consent-to-the-data-guideline-and-confirmation-of-the-authorization-and-the-first-publication","l":"Upload form: Specification of additional information, consent to the data guideline and confirmation of the authorization and the first publication","p":["Additional Information","If the upload was successful, a summary of the submitted information appears. The processing status can also be viewed on this page. As long as the submitted data are formally checked"]}],[{"l":"Submission Details","p":["List of all records","(Status: Submitted), it is possible to make changes. As soon as the data have been added to the database and the metadata have been sent(Status: in progress), contact must be made with the BonaRes Centre for subsequent changes.","The history gives an overview of the completed processing steps of the respective dataset.","An overview of all datasets submitted so far appears in the user account under “Submission” under “My dataset submissions”. If you have any questions or problems, the ticket number should always be given.","After a dataset has been transferred to the BonaRes Centre, it is checked formally and in terms of content (e. g. thematically fit into the BonaRes Repository) by data stewards. Formal checks are, e. g. empty columns, outliers or not plausible values. Conspicuous data are communicated back to the data provider. In the future, the test should carried out by an automated tool. After a dataset passed this formal check, further metadata will be prepared (see chapter Metadata), which can be downloaded as PDF."]}],[{"l":"Frequently Asked Questions"},{"i":"can-i-upload-an-excel-table-with-multiple-sheets","l":":heavy_check_mark: _Can I upload an excel table with multiple sheets?_","p":["No. Each excel sheet should be uploaded separately. However, if the datasets are related, you have to fill the metadata template just once."]},{"i":"how-long-does-it-take-to-obtain-the-doi","l":":heavy_check_mark: How long does it take to obtain the DOI?","p":["With complete metadata it takes normally 2-3 business days depending on the work load"]},{"i":"what-is-an-embargo","l":":heavy_check_mark: What is an embargo?","p":["Embargo refers to a period during which the data cannot be downloaded."]},{"i":"can-i-get-an-inactive-doi-during-the-embargo-period","l":":heavy_check_mark: _Can I get an inactive DOI during the embargo period?_","p":["No. Only active DOI are sent to the authors."]},{"i":"what-is-the-maximum-period-of-embargo","l":":heavy_check_mark: _What is the maximum period of embargo?_","p":["24 Months. However, the less the period the better."]},{"i":"what-if-i-made-a-mistake-and-need-to-correct-it-after-i-received-my-doi","l":":heavy_check_mark: _What if I made a mistake and need to correct it after I received my DOI?_","p":["Metadata can be edited by the data stewards but the dataset cannot be changed. Contact the support team and they will help you."]},{"i":"which-languages-can-i-use-in-my-datasets-columns-and-description","l":":heavy_check_mark: _Which languages can I use in my datasets columns and description?_","p":["English"]},{"i":"for-how-long-will-my-datasets-be-hosted","l":":heavy_check_mark: _For how long will my datasets be hosted?_","p":["More than 10 years"]},{"i":"under-which-license-are-data-and-metadata-made-available-to-reusers","l":":heavy_check_mark: _Under which license are data and metadata made available to reusers?_","p":["Data is available under the cc BY4.0 license","Metadata is available under cc0 license"]},{"i":"in-what-format-should-the-dataset-be-uploaded","l":":heavy_check_mark: _In what format should the dataset be uploaded?_","p":["Only upload files of property 'txt', 'csv', 'xls', 'xslx', 'zip', 'docx', 'jpg', 'pdf', 'shp', 'tif', 'tiff', 'png', 'gif'and with a size smaller than 30 MB."]},{"i":"can-i-upload-datasets-bigger-than-30-mb","l":":heavy_check_mark: _Can I upload datasets bigger than 30 MB?_","p":["No. However, you can contact the support team and they will help you."]},{"i":"where-can-i-find-an-overview-about-the-status-of-my-data-submissions","l":":heavy_check_mark: _Where can I find an overview about the status of my data submissions?_","p":["Login to the upload tool and check under ‘My submissions’ in the upper right section."]},{"i":"is-there-any-fee-associated-with-data-publishing-in-the-bonares-repository","l":":heavy_check_mark: _Is there any fee associated with data publishing in the BonaRes Repository?_","p":["No"]},{"i":"how-will-my-dataset-be-cited","l":":heavy_check_mark: _How will my dataset be cited?_","p":["Once the dataset is published, you can copy the citation in the ‘access’ section of the metadata."]},{"i":"can-i-link-a-paper-or-other-publication-to-my-dataset","l":":heavy_check_mark: _Can I link a paper or other publication to my dataset?_","p":["Yes. Upload all related works and specify in the metadata template how they are related to the dataset to be published."]},{"i":"who-can-be-considered-an-author-of-a-dataset","l":":heavy_check_mark: _Who can be considered an author of a dataset?_","p":["An author can be a student, scientist, technician, or any other individual provided they contributed to the collection and processing of data.","Note that data authors can be different from the authors of the paper that was published based on the data.","To determine who an author is, please follow principles of good scientific practice (refer to the BonaRes Data Guideline in the upload tool)."]}],[{"l":"Frequently Asked Questions"},{"l":"BonaRes Repository","p":["Leibniz Centre for Agricultural Landscape Research (ZALF) Eberswalder Strasse 84 15374 Müncheberg, Germany (+49) 033432 82 300 dataservice@zalf.de https://www.bonares.de/research-data"]}]]
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 0d6dfc7..b0de602 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ
diff --git a/submission_details/index.html b/submission_details/index.html
index 4760141..e924409 100644
--- a/submission_details/index.html
+++ b/submission_details/index.html
@@ -3,7 +3,7 @@
-
+
@@ -33,11 +33,11 @@
-
+
-
+
-
+
@@ -71,13 +71,13 @@