Skip to content

Commit d045766

Browse files
authored
Merge pull request #230 from CavRiley/Update-testing-section
DOC: Update development guide testing section
2 parents 0ca2382 + 871011b commit d045766

File tree

1 file changed

+13
-9
lines changed

1 file changed

+13
-9
lines changed

SoftwareGuide/Latex/DevelopmentGuidelines/CreateAModule.tex

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -320,15 +320,19 @@ \section{Tests}
320320
macro. Content link files, stored in the source code directory, are replaced
321321
by actual content files in the build directory when CMake downloads the
322322
\code{ITKData} target at build time. A content link file has the same name as
323-
its target, but a \texttt{.sha512} extension is added, and the \texttt{.sha512}
324-
file's contents are only the SHA512 hash of its target. Content links for data
325-
files in a Git distributed version control repository prevent repository
326-
bloat. To obtain content links, register an account at
327-
\url{https://data.kitware.com}. Upload images to your account's
328-
\texttt{My folders/Public} folder. Once the image has been uploaded, click on the
329-
item's link, then click the \texttt{Show info} icon. A \texttt{Download key
330-
file} icon will be available to download the content link. Place this file in
331-
the repository tree where referenced by the \code{DATA} macro.
323+
its target, but a \texttt{.cid} extension is added, and the \texttt{.cid}
324+
file's contents are only the Content Identifier (CID) hash from the
325+
InterPlanetary File System (IPFS). Content links for data files in a Git
326+
distributed version control repository prevent repository bloat. To obtain
327+
content links, register an account at \url{http://content-link-upload.itk.org}.
328+
IPFS provides permission-less uploads, meaning users can simply upload
329+
images and easily retrieve the CID. Once the image has been uploaded, click on the
330+
item's link to download or copy the CID to the appropriate \texttt{.cid} file.
331+
Place this file in the repository tree where referenced by the \code{DATA} macro.
332+
In cases where output depends on the runtime environment, multiple baseline images
333+
may be required. This can be accomplished by appending an integer to the filename
334+
before the extension, such as \texttt{itk<ClassName>Test.<ext>.1.cid} or
335+
\texttt{itk<ClassName>Test.<ext>.2.cid}, where each variant represents a valid baseline.
332336
333337
When a test requires a new (or modified) input or baseline image dataset,
334338
the corresponding content link files have to be provided as well. Image

0 commit comments

Comments
 (0)