This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
submission_guide [2022/10/07 00:27] – [File Submission] scmfcl | submission_guide [2023/03/16 12:11] (current) – [Extremely Large Files/Archives] scmfcl | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Submission Guide ====== | ====== Submission Guide ====== | ||
- | This explains how to submit the deliverables for your final year project. For what to submit check the relevant deliverable section for your project module. | + | This explains how to submit the deliverables for your final year project. For what to submit, check the relevant deliverable section for your project module. |
- | All deliverables must be submitted via PATS, except for physical artefacts. Some larger datasets, videos or similar that are only for general support or context may be provided elsewhere. All submissions must contain at least one PDF file in the document files section or they will not be accepted by PATS and so submission | + | All deliverables must be submitted via PATS, except for physical artefacts. Some larger datasets, videos or similar that are only for general support or context may be provided elsewhere. All submissions must contain at least one PDF file in the document files section, or PATS will not allow you to complete the submission. |
- | Submission | + | Submission generally |
- | After you completed | + | After completing |
- | In a submission on PATS we usually expect a report with sufficient evidence to back up your claims such that they can be verified and reproduced. Often the report with sources is sufficient | + | In a submission on PATS, we usually expect a report with sufficient evidence to back up your claims such that they can be verified and reproduced |
- | ====== File Submission | + | ===== File Submission ===== |
- | For each deliverable PATS has two sections to submit files: | + | For each deliverable, PATS has two sections to submit files: |
- | * **Document files**: These must be PDF files and each submission must have at least one of these files - this section is for the written report, including any appendices. See the **[[PDF Guide]]** for information on how to create | + | * **Document files**: These must be PDF files, and each submission must have at least one of these files - this section is for the written report, including any appendices. See the **[[PDF Guide]]** for information on creating |
- | * **Support files**: These are any additional files you wish to submit for your project. They are not part of the main report, but for supplementary material or extended appendices | + | * **Support files**: These are any additional files you wish to submit for your project. They are not part of the main report but form supplementary material or extended appendices. Often these are archives (we try to convert some of them to zip files for compatibility) containing code, data or computational/ |
- | What is suitable to submit often depends on your project and your report. Please discuss with your supervisor what you should include if you are unsure. Your supervisor and moderator | + | What is suitable to submit often depends on your project and your report. Please discuss with your supervisor what you should include if you are unsure. Your supervisor and moderator |
- | To add files to these sections, press one of the related | + | To add files to these sections, press one of the related |
- | For the files in the document section you can check if there could be potential issues with the PDF files. You can also combine all files in this section into a single file (PATS will do this automatically upon submission completion). | + | For the files in the document section, you can check if there could be potential issues with the PDF files. You can also combine all files in this section into a single file (PATS will do this automatically upon submission completion). |
- | After you have uploaded at least one file to the document files section you can complete the submission. This will generate a zip file containing all the files you have uploaded in all sections, sorted by these sections and in order they are displayed in the submission area. The document files will be combined into a single PDF file. **Your files count as submitted only after you have completed the submission**. While files in the content area are visible to your supervisor and moderator, they do not ncount | + | After you have uploaded at least one file to the document files section, you can complete the submission. This will generate a zip file containing all the files you have uploaded in all sections, sorted by these sections, and in order they are displayed in the submission area. The document files will be combined into a single PDF file. **Your files count as submitted only after you have completed the submission**. While files in the content area are visible to your supervisor and moderator, they do not count as submitted nor serve as extensions to the submission; they will be ignored. |
You can resubmit at any time before the deadline (all deadlines are by 23:00 on the day shown). A resubmission will completely replace the previously submitted files and not extend the previous submission, so always upload all files into the submission area and then submit them all at once by completing the submission. You can delete the archive at any time before the deadline and also download the archive to verify its contents. | You can resubmit at any time before the deadline (all deadlines are by 23:00 on the day shown). A resubmission will completely replace the previously submitted files and not extend the previous submission, so always upload all files into the submission area and then submit them all at once by completing the submission. You can delete the archive at any time before the deadline and also download the archive to verify its contents. | ||
- | **Make sure you check the contents of any files you upload in the file submission area and especially the contents of the final submission archive. | + | **Make sure you check the contents of any files you upload in the file submission area and especially the contents of the final submission archive. Files uploaded via the network may sometimes be corrupted, and downloading them again to verify their content avoids any problems. To verify the files, you may also use the checksums.** See **[[Checksums]]** for further information. (Some PDF files and archives are modified for compatibility and so the checksums are not the same as your local files). |
- | ====== Physical Artefacts | + | ===== Physical Artefacts ===== |
- | Some projects may also produce physical artefacts without any digital versions of them. Hardware or similar physical objects | + | Some projects may also produce physical artefacts without any digital versions of them. Hardware or similar physical objects |
- | Anything that fits on an A4 page or smaller can be scanned and directly included in the report as a figure. For documents larger than A4 we recommend taking photos | + | Anything that fits on an A4 page or smaller can be scanned and directly included in the report as a figure. For documents larger than A4, we recommend taking photos and submitting |
- | If you are having | + | If you have any problems with this, discuss them with your supervisors and potentially with our IT Service Desk. |
- | ====== Extremely Large Files/ | + | ===== Extremely Large Files/ |
- | We have no strict file size limitations for the submissions. But some project | + | We have no strict file size limitations for the submissions. But some projects |
+ | |||
+ | You may make larger files/ | ||
====== Submission Problems and Peace of Mind ====== | ====== Submission Problems and Peace of Mind ====== | ||
- | After you submitted | + | After you complete the submission of your files on PATS, your deliverable counts as submitted, and you do not have to do anything else. You can verify your submission yourself by checking the provided submission archive. We do not expect any problems with the network connection, the server or the integrity of your submitted file. However, to avoid any problems with the integrity of your submission and to deal with any problems arising from the server, Internet connections or anything else that prevents you from submitting the project in time, please follow these instructions: |
* Put all the files you wish to submit into some archive file (similar to the submission archive generated by PATS). | * Put all the files you wish to submit into some archive file (similar to the submission archive generated by PATS). | ||
- | * Upload the archive on a private online file share, such as your onedrive linked to your university account (this is the best option, if possible), google drive, dropbox, etc. It is important that you cannot change the timestamp | + | * Upload the archive on a private online file share, such as your onedrive linked to your university account (this is the best option, if possible), google drive, dropbox, etc. It is important that you cannot change the timestamp |
- | * Keep this file unmodified with a verifiable timestamp on the site (at least until you get your mark returned). As the timestamp can serve as a verification that you created the file before deadline, you can later on share this with your supervisor, moderator and project coordinator if there is a problem with your submission. | + | * Keep this file unmodified with a verifiable timestamp on the site (at least until you get your mark returned). As the timestamp can serve as a verification that you created the file before |
- | * If for some reason you cannot upload your files onto PATS you can also share this file immediately (before deadline) with the project coordinator who will fix and complete your submission on PATS. | + | * If, for some reason, you cannot upload your files onto PATS, you can also share this file immediately (before |
+ | Generally, sharing files with the project coordinator before the deadline works well to resolve any issues. But note that it may take some time until we can get back to you to sort out the problem. | ||
- | If for some reason you are unable to submit your files online anywhere, there is a further offline alternative | + | If, for some reason, you are unable to submit your files online anywhere, there is a further offline alternative |
- | * Put all the files you wish to submit into some archive file (similar to the submission archive generated by PATS). Store this somewhere safe so you can produce this file in person or later on via some file sharing mechanism online | + | * Put all the files you wish to submit into some archive file (similar to the submission archive generated by PATS). Store this somewhere safe so you can produce this file in person or later on via some file-sharing mechanism online |
- | * Create a checksum of this file (see **[[Checksums]]**) and send this checksum to your supervisor, moderator or project coordinator. It must arrive before deadline. It can be send by e-mail or given in-person with your full name and student id. You can also give it to someone at the COMSC office. Tell them to forward this to the project coordinator. Note that it may be hard to reach anyone in person, so this does not work as a last minute option (e-mailing the checksum before deadline would of course work). | + | * Create a checksum of this file (see **[[Checksums]]**) and send this checksum to your supervisor, moderator or project coordinator. It must arrive before |
- | * The project coordinator will then be in touch to arrange | + | * The project coordinator will then be in touch to arrange |
- | So far we never needed | + | So far, we have never had to use this approach. |
====== Recommended File Types ====== | ====== Recommended File Types ====== | ||
- | You are free to use any file types as long as they are suitable | + | You can use any file type as long as they are suitable |
- | * Documents: Whenever possible use PDF. Note, the main report must be in PDF format. | + | * Documents: Whenever possible, use PDF. Note the main report must be in PDF format |
- | * Sources: Sources, interpreted files, HTML files, etc. should usually be plain text files encoded in ASCII, UTF-8 or ISO 8859-1 (latin1). Other standard text encodings may be used, if necessary. | + | * Sources: Sources, interpreted files, HTML files, etc., should usually be plain text files encoded in ASCII, UTF-8 or ISO 8859-1 (latin1). Other standard text encodings may be used if necessary. |
- | * Images: The JPEG or PNG formats are preferred, for compatibility. An image quality of 90% is usually sufficient for JPEG. | + | * Jupyter, matlab, etc. notebooks: consider if these are really suitable for the purpose (e.g. PDF files generated from them may be more suitable for showing analysis results) and make sure you submit them completely, including any separate data needed. They may not be viewable by your markers in any case, so are best treated as optional files for completeness/ |
- | * Video: Use MP4, MKV or WEBM container formats. The H.264/AVC and AV1 codecs are preferred, for compatibility and quality. Usually the resolution does not have to be greater than 1080p (1920x1080), 720p (1280x720 pixels) is often sufficient; 1440p (1920×1440) only if high resolution is needed. | + | * Images: The JPEG or PNG formats are preferred for compatibility. An image quality of 90% is usually sufficient for JPEG. |
- | * Audio: Use OGG or MP3 for lossy compression or FLAC for lossless compression. For MP3 a sampling rate of 32kbps is sufficient for voice and analog | + | * Video: Use MP4, MKV or WEBM container formats. The H.264/AVC and AV1 codecs are preferred for compatibility and quality. Usually the resolution does not have to be greater than 1080p (1920x1080); 720p (1280x720 pixels) is often sufficient; 1440p (1920×1440) |
+ | * Audio: Use OGG or MP3 for lossy compression or FLAC for lossless compression. For MP3, a sampling rate of 32kbps is sufficient for voice and analogue |