aasjournals / aastex60 Goto Github PK

Any deluxetable or deluxetable* containing more rows than can fit on one page will run off the bottom of the page rather than break and continue on the next page. Neither \LongTables nor \tablebreak seem to fix this behavior. Also see this relevant twitter conversation.

Hi,

I'm having problems keeping hyphenated words, inline equations, and hyperlinks within the boundaries of the column (at least when using the twocolumn option) for AASTeX v6.1.
I haven't seen this happening in v6.0/preprint2, so it seems to be something related to v6.1.

Here's a minimal example:

\documentclass[tighten, times, twocolumn]{aastex61}
\begin{document}

\title{A bug report using aastex v6.1}
\author{Patricio}

\section{Introduction}

This is a normal piece of text showing the length of a column,
everything is good so far.  Actually, many thanks to everyone in the
the AASTeX developer team.

However, sometimes the twocolumn option misses hyphenated-word boundaries.

Some inline equations also break, e.g., $\gamma=0.071
(T/2000)^{-0.7}$ cm$^{-1}$ atm$^{-1}$.
\end{document}

And here's the output: http://geco.oeaw.ac.at/patricio/subdir/aastex/sample61.pdf

The spacing around the &=& symbol (or whatever) has been squeezed relative to the standard article class. Can we turn this off, or make it a binary option? Happy to help implement this change.

The following diff was applied to original (January 6, 2016) version of the AASTeX60/cls/aastex6.cls file before uploading to github to fix a widely reported bug.

< \newcommand\apjl{\ref@jnl{\@eapj@ApJLetters}}%     % Astrophysical Journal, Letters 

---
> %\newcommand\apjl{\ref@jnl{\@eapj@ApJLetters}}%     % Astrophysical Journal, Letters 
> \newcommand\apjl{\ref@jnl{ApJL}}%      % Astrophysical Journal, Letters

Apparently deep in the bowels of revtex4-1 there is a \doi{<var>} command definition that automatically takes the target text <var>, rewrites it as doi:<var>, and anchor links it to http://dx.doi.org/<var>. We should do something with this, including documenting it.

When using amsmath matrix, there is an error "Missing number, treated as zero." Here is an example that has the problem. Note that aastex works fine.

\documentclass{aastex6}
\usepackage{amsmath}
\begin{document}
\begin{equation}
\begin{pmatrix}
1.000 & 0.624 & -0.318 & -0.287
0.624 & 1.000 & -0.180 & 0.104
-0.318 & -0.180 & 1.000 & 0.629
-0.287 & 0.104 & 0.629 & 1.000
\end{pmatrix}.
\end{equation}
\end{document}

We are now using hyperref as a standard import with AASTeX 6. Authors need not import the package, and hyperref changes should be made using \hypersetup. However this produces an inconsistency in the font encoding of \url and \href.

http://tex.stackexchange.com/questions/202128/how-to-get-url-and-href-displayed-identically

We should force all \url to match \href font encodings to roman by automatically triggering \urlstyle{rm} to AASTeX. There may be implications wrt to other font encoding issues that I have not yet explored.

Note this may be fixed in AASTeX 6.1 but it has not been tested.

\turnoffedit will disable all highlights including \edit1, \edit2 and \edit3.
However, in a normal submission process, we always need to hide \edit1 when submitting revision 2.
It is also required to hide \edit2 when submitting revision 3.
If the edits can not be hidden according to revision phases, I do not think this feature is better than traditional \textbf

For some mystifying reason, compiling my AASTeX v6.1 manuscript fails on my Ubuntu 16.10 machine, but works perfectly fine on my macOS Sierra setup (which uses TeXShop and MacTex). I've found a solution I only vaguely understand, and I'm hoping for some insight. I suspect this may impact a subset of AASTeX users.

The Issue

When compiling (either via latex manuscript.tex or pdflatex manuscript.tex) on my Ubuntu machine, I receive the following error:

pdflatex: Not writing to .bib (openout_any = A).

! I can't write on file `.bib'.
<to be read again> 
                   \relax 
l.53 \begin{document}

(Press Enter to retry, or Control-D to exit; default file extension is `.tex')
Please type another output file name: 

I can then give any filename (e.g. junk), the compilation will continue (successfully), and a blank junk.tex will be written alongside the expected output. Note that this issue does not arise when compiling via TeXShop (using either latex or pdflatex) on my Mac.

The Solution

While I understand that the error is related to LaTeX's default (p)aranoid setting, I don't really understand exactly why this works (because the issue only arises on my Ubuntu machine). I can only thank this Japanese blog post for the help. I'm clearly not the only one with this issue!

The quick way : Explicitly set openout_any=a pdflatex manuscript.tex before you compile. This solves the issue.

It appears that the root cause lies in lines 6322 and 6323 of aastex61.cls. Commenting them out will also solve the issue, and negate the need to explicitly set openout_any=a before you compile. That is,

%% get rid of \jobname Notes being sent to .aux file:
\let\bibdata@app\relax
\def\pre@bibdata{}

Commenting those two lines, i.e.,

%% get rid of \jobname Notes being sent to .aux file:
%\let\bibdata@app\relax
%\def\pre@bibdata{}

solves the issue.

If you have a deluxetable in floattable mode, you get a crash if the final table row does not end with a \\. Standard LaTeX tables should not have a \\ at the end of the final row so it's not crazy to think that this might happen. I mean, I ran into the issue. Sample:

\documentclass{aastex6}
\begin{document}
\title{Demo}
\author{Me}
\begin{abstract} Hello \end{abstract}

\floattable
\begin{deluxetable}{cc}
\tablecaption{Demo}
\tablehead{
\colhead{1} & \colhead{2}
}
\startdata
a & b \\
c & d % !!!! crash if no "\\" placed here
\enddata
\end{deluxetable}

\end{document}

Results in:

./demo.tex:16: Misplaced \omit.
\startdata ... {\vskip -9pt}\pt@head \par #1\omit 
                                                  \\\omit \\\hline \end {tab...
l.16 \enddata

./demo.tex:16:  ==> Fatal error occurred, no output PDF file produced!

Seen with aastex6 version 6.0 (March 2, 2016).

Given you don't want to support every possible TeX install environment/scenario, it could still be very useful to have some examples of how to install the .cls and .bst files so that you don't have to copy/paste them in to every project directory.

The AAS journals center the affiliations for authors, and it was possible to mimic this behavior with emulateapj. For example, see the ApJ and emulateapj versions of the paper below:

• ApJ: http://iopscience.iop.org/article/10.1088/0004-637X/808/1/95/pdf
• emulateapj: https://arxiv.org/pdf/1504.02889v2.pdf

Compare with the version using aastex61:

• aastex61: aastex61_example.pdf

It appears that with aastex61 the affiliations are centered with the longauthor option, but not in the default twocolumn format. I'm going to look into a style adjustment to center affiliations in twocolumn format, and any suggestions that point me the right direction would be appreciated.

UPDATE
On further examination, I actually think that affiliations should be centered for all document styles (e.g., manuscript,preprint, preprint2,modern, and twocolomn). I would also argue that the vertical space between the author list/collaboration tag is too large compared to ApJ style. Similarly, the space between the title and author list is larger than the ApJ (or emulateapj) equivalent.

Comments from @davidwhogg, @dfm, @augustfly, @gregschwarz especially welcome.

A use of \added{} that contains a \footnote shows the added text in the correct (red) colour, but the footnote does not show up in the List of Changes generated at the end of the document.

@cmccully suggests shrinking the width and center the abstract like emulateapj (e.g. https://www.sharelatex.com/templates/journals/emulateapj). This was originally proposed in #38, but is better kept in a separate issue.

@augustfly was this slated for v6.3?

When printed on a b/w printer, the urls, refs, etc, appear very light grey. Let's use navy for all these, or black.

From: https://tex.stackexchange.com/questions/393150/centering-a-very-wide-deluxetable

There appears to be a bug in the \startlongtable that prevents the normal behavior of deluxetable to center the table and overflow both the left and right margins equally. I can show it to be independent of style (tested for modern and preprint).

In previous AASTeX versions one was able to include a footnote in the title. An example might be including the obligatory 'This paper includes data gathered with the 6.5 meter Magellan Telescopes located at Las Campanas Observatory, Chile'. In version 6.0 the footnote doesn't render. Is this intentional? Is there a new recommended way to include a footnote like this? Or is this "bad practice" that AASTex v6+ is trying to stamp out?

I can put in long footnotes, or many footnotes, and they go below the bottom of the page; they never break onto another page or cut the text differently. This is a low-priority issue, because I can do work-arounds, but probably signals some long-term issues with the footnotes or pagination. Let me know if you want a demo.

It doesn't align with the left margin!

The release version of aasjournal.bst picks up the "note" field in @misc and @article bibtex entries and appends the note text to the end of the compiled \bibitem.

This is unwanted behavior.

The work around is to hand edit the compiled bbl file to remove the note text or to edit the source bibtex to remove the note field or rename the "note" key to something else, e.g, adsnote, or zenodonote.

The following code will throw a ! Missing number, treated as zero. error, but if you swap the \tablehead line with the one commented out below so that the colhead value doesn't contain an "h" or an "H" then it will compile. This is the most baffling LaTeX bug I've ever seen.

\documentclass{aastex6}
\begin{document}
\title{Demo}
\author{Me}
\begin{abstract} Hello \end{abstract}


\begin{deluxetable}{crrrlcl}
\tablecolumns{7}
\tablecaption{ludicrous error}
\tablehead{\colhead{Width} & \colhead{H} & \colhead{R} & \colhead{D} & \colhead{E} & \colhead{F} & \colhead{G}}
%\tablehead{\colhead{W} & \colhead{X} & \colhead{R} & \colhead{D} & \colhead{E} & \colhead{F} & \colhead{G}}
\startdata
3 & 4 & 5 & 6 & 7 & 8 & 9 \\
3 & 4 & 5 & 6 & 7 & 8 & 9 \\
3 & 4 & 5 & 6 & 7 & 8 & 9 \\
\enddata
\tablecomments{}
\end{deluxetable}

\end{document}

when using
\documentclass[manuscript]{aastex61}
for example in sample61.tex,
all \tablehead will have an extra white line above the head text in the final PDF page.

Using the following instructions:

\begin{deluxetable}{lrr}
\tablecolumns{3}
\tablewidth{0pt}
\tablecaption{\label{tbl:counts} Number of images in each filter.}
\tablehead{
\colhead{Filter} & \colhead{WAC} & \colhead{NAC}}
\startdata
VIO & 658 & \nodata
BL1 & 201 & 426
\hline
Total & 3283 & 1714
\enddata
\end{deluxetable}

The resulting table has nearly a whole extra row after the "Total" line. Preceding the commands with \floattable causes the table to then appear normally but in two column format spans both columns.

Am I missing something?

I have this Zenodo DOI project here:
https://zenodo.org/record/51824#.V0Is5lesSAY
with a Bibtex record like this (as produced by that page):

@misc{k_michael_aye_2016_51824,
  author       = {K.-Michael Aye},
  title        = {pyciss: v0.3.2},
  month        = may,
  year         = 2016,
  doi          = {10.5281/zenodo.51824},
  url          = {http://dx.doi.org/10.5281/zenodo.51824}
}

and the aastex.bst together with AASTex 6 makes this out of it:

Aye, K.-M. 2016, pyciss: v0.3.2, , , doi:10.5281/zenodo.51824

Your instructions here:
http://journals.aas.org/policy/software.html
say:

Citing a DOI for the software, for example, obtained via Zenodo or FigShare (e.g. Foreman-Mackey et al. 2014, corner.py, v0.1.1, Zenodo, doi:10.5281/zenodo.11020, as developed on GitHub)

From this it looks like that Bibtex should interpret an actual version field, because it is separated from the project title, plus it has a Zenodo item that is not even procuded by the Zenodo Bibtex record exporter. Are these the 2 missing items indicated by the three commas in what is currently being made out of my current BibTex entry? What are the field names for that so that I could hot-fix my record on my own.
Maybe this should be solved together with Zenodo so that their BibTex exporter matches more closely the requirements of AASTex? Alternatively, AASTex could support BibLatex that supports more kinds of online citations with more options, IIRC.

I'm having an issue in which citations in the "old text" part of \replaced break compilation. They seem to be fine in the "new text" part, or if I turn off trackchanges.

For example,

\replaced{\citep{FirstAuthEtAl2010}}{\citep{FirstAuthEtAl2007, FirstAuth2EtAl2010}}

will not compile, but

\replaced{FirstAuthEtAl2010}{\citep{FirstAuthEtAl2007, FirstAuth2EtAl2010}}

will. This is a fairly minor issue, but I figured I would alert the developers of it.

AASTeX has the \facility{} macro to allow the author to specify observational facilities. This helps facilities aggregate the papers that made use of their service.

Can the same be done for Computational facilities? e.g.,
NERSC: http://www.nersc.gov/
OLCF: https://www.olcf.ornl.gov/
ALCF: https://www.alcf.anl.gov/
...

(there are probably dozens or hundreds more)

I thought astronomers formatted dates as

• 2016 September 10, or
• 2016-09-10 (ISO 8601)

Am I wrong? If I am not, then we should switch to one of these in the top slugcomment.

1. add DOIs for all \bibitem where they are found. related to #47 . Add as default newblock. Styling (nice anchor text) can be ignored. Also catch eprint ids for arXiv and ASCL, but don't break ASCL. Use ASCL as test case.

2. Fix bst picking up the note field in #44

3. Revert version tag documentation and bibtex style to not add the "v" to the version field, but just take whatever the author gives us.
   This is preferred because we do not want to prescribe any versioning style, leaving it up to the author or bibtex provider to specify their bibtex format.
   The aasjournal.bst fix is:
   FUNCTION {bbl.version} { "v" }
   to
   FUNCTION {bbl.version} { "" }

They do not remove the color of the text, but just remove the text included in the braces...
eg, "I am a \edit1{robot}." becomes "I am a ." in the final PDF.
if \turnoffedit or \turnoffeditone

and there is always an unwanted huge space after each \edit1{}, sometimes it even makes a \par effect..

at 0.5in; this is true for both the abstract and the keywords. Make it a length and then the user can tweak.

Many institutions require the inclusion of internal preprint or report numbers. In revtex4-1, this is performed using the \preprint command and the document class option preprintnumbrs (documented in Section 9.2.5 of the revtex4-1 docs).

Is there any equivalent in aastex6.1? The \preprint command and preprintnumbers options appear to be defined (at least I don't see an error during compilation), but nothing is displayed in the output. Below is a minimal working example:

\documentclass[preprint,preprintnumbers]{aastex61}
\begin{document}
\preprint{REPORT-123}
\title{Hello World}
\begin{abstract}
Hello world!
\end{abstract}
\section{Introduction}
Introducing ... hello world!
\end{document}

There are rules about how many characters / words there should be for a line to be readable, the preprint option violates them. See, eg, Bringhurst http://www.amazon.com/Elements-Typographic-Style-Robert-Bringhurst/dp/0881791326

As bst is slowly dying out, I was wondering if there's any plan to add biber/biblatex compatibility to AASTeX?

I don't understand why we switched the default behavior of emulateapj from two column to one column.

\documentclass{emulateapj} => defaults to 2 column
\documentclass{aastex6} => defaults to 1 column

The version function does not need a trailing period "." see http://semver.org/ or common practice

https://github.com/AASJournals/AASTeX60/blob/master/bst/aasjournal.bst#L290-L291

should be

FUNCTION {bbl.version}
{ "v" }

For authors who wish to provide inline links to data that should not otherwise be cited, e.g., raw data; e.g., MAST data collections, rewrite the current \dataset AASTeX6 function to take advantage of our use of hyperref and provide a "DATASET" inline link authors can markup in their manuscripts.

The latex markup:

We used HST data \dataset{doi} to find...

would produce the following inline

We used HST data [DATALINK] to find...

The underlying markup should be something like

\href{#1}{[DATALINK]}

This is a discussion issue.

We are looking to improve (and formalize) software markup in AASTeX articles. There are at least 2 packages currently in use by AAS Journal authors to mark up software inline to their LaTeX/AASTeX manuscripts:

• minted : https://github.com/gpoore/minted
• listings : https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings

An example of minted + AASTeX can be found in the published version of Bovy's "galpy" article and in the ms.in file in the galpy arXiv source:

• arXiv source: http://arxiv.org/format/1412.3451v1
• ADS page: https://ui.adsabs.harvard.edu/#abs/2015ApJS..216...29B/abstract
• Final production article: http://dx.doi.org/10.1088/0067-0049/216/2/29

An example of listings + AASTeX can be found in the published version of VanderPlas & Ivezic's "Periodograms for Multiband Astronomical Time Series" and its arXiv source:

• arXiv source: http://arxiv.org/format/1502.01344v1
• ADS page: https://ui.adsabs.harvard.edu/#abs/2015ApJ...812...18V/abstract
• Final production article: http://dx.doi.org/10.1088/0004-637X/812/1/18

Comments and suggestions are welcome.

The dataset macro is suppose to have two conditions:

Case 1:
\dataset[]{https://doi.org/10.5281/zenodo.831784}
=> [DATASET]

or

Case 2:
\dataset[at this Zenodo repository]{https://doi.org/10.5281/zenodo.831784}
=> at this Zenodo repository

but it currently forces the addition of square brackets in Case 2 above.

\dataset[at this Zenodo repository]{https://doi.org/10.5281/zenodo.831784}
=> [at this Zenodo repository]

which wasn't the design spec and made it through v6 and v6.1

also related to #47 -- which we should rewrite to always use the correct Crossref display requirement

The indents of a paragraph should look like empty square blocks. See, eg, Bringhurst http://www.amazon.com/Elements-Typographic-Style-Robert-Bringhurst/dp/0881791326

See: http://journals.aas.org/authors/aastex/linux.html

For users on Linux operating systems, one change in v6.1 will cause problems on compilation. A hidden ".bib" file is created in v6.1 but the default behavior LaTeX on Linux is to not allow any files to be written that begin with a period. This is not a problem on Windows or Mac operating systems. There are two work arounds available until this bug is fixed.

• Comment out these lines in aastex61.cls

%% get rid of \jobname Notes being sent to .aux file:
\let\bibdata@app\relax
\def\pre@bibdata{}

• Change the command line compiler call to allow a "." file by passing the environmental variable openout_any=a

openout_any=a pdflatex file

Every thing I have ever put on arXiv has been preprint style, but 12 pt. That's no longer possible? I would be fine with this if it didn't violate rules in Bringhurst. http://www.amazon.com/Elements-Typographic-Style-Robert-Bringhurst/dp/0881791326

First, thanks for the nice fixes in v6.1. With this new version it seems as though I am unable to get my document text (other than author and abstract information) to actually start on page 1, regardless of how short the abstract is. This happens with the default, twocolumn, and modern styles. Is this intentional?

I've attached an example.
main.pdf

Latex here: https://gist.github.com/iancze/e26d3b3ea833cb97d601dc8455fcf382

Thanks!

Hi,

I seem to be running into an issue where trying to reference a figure in the appendix will jump instead to the corresponding figure in the main text, i.e. if I have a figure B1 in the appendix with some label \label{fig:labelforB1}, then "Figure \ref{fig:labelforB1}" will correctly compile as "Figure B1," but the actual hyperlink jumps to Figure 1 instead.

With alignment argument D, it will fail to reconstruct the table in sample61.tex
Comment % \decimalcolnumbers

\begin{deluxetable*}{cchlDlc} \tablenum{4} \tablecaption{Fun facts about the first 10 messier objects\label{tab:messier}} \tablewidth{0pt} \tablehead{ \colhead{Messier} & \colhead{NGC/IC} & \nocolhead{Common} & \colhead{Object} & \multicolumn2c{Distance} & \colhead{} & \colhead{V} \\ \colhead{Number} & \colhead{Number} & \nocolhead{Name} & \colhead{Type} & \multicolumn2c{(kpc)} & \colhead{Constellation} & \colhead{(mag)} } % \decimalcolnumbers \startdata M1 & NGC 1952 & Crab Nebula & Supernova remnant & 2 & Taurus & 8.4 \\ M2 & NGC 7089 & Messier 2 & Cluster, globular & 11.5 & Aquarius & 6.3 \\ \enddata \tablecomments{This table ``hides'' the third column in the \latex\ when compiled. The Distance is also centered on the decimals. Note that when using decimal alignment you need to include the {\tt\string\decimals} command before {\tt\string\startdata} and all of the values in that column have to have a space before the next ampersand.} \end{deluxetable*}

For now here is a list (otherwise forked into our repository).

• Review @pkgw Yet Another "H" ApJ

Hello and New Year's greetings,
See the title of the question and just make it possible like below.
This might be useful for submitting to eprint sites.

FROM aastex61.cls

 \usepackage[bookmarks=false,         % show bookmarks bar?
     pdfnewwindow=true,      % links in new window
     colorlinks=true,    % false: boxed links; true: colored links
     linkcolor=xlinkcolor,     % color of internal links
     citecolor=xlinkcolor,     % color of links to bibliography
     filecolor=xlinkcolor,  % color of file links
     urlcolor=xlinkcolor,      % color of external links
     pdfauthor={Authors from the main tex},
      pdftitle={Title from the the main tex},
      pdfkeywords={keywords from the tex);
      pdfsubject={SUBJECT},
final=true
 ]{hyperref}

Thank you.

I have an appendix that is in single-column mode. If I include a deluxetable, all of the text beyond it shows up in two-column mode instead. Not exactly the biggest deal, but it looks a bit weird and is presumably not intended.

We should point out in the sample file that we now have hyperref as a builtin:

which means authors can:

1. use \url{} without LaTeX encoding special characters;
2. use \href{}{} to create inline links;

The \deleted and similar markup features are very useful when, for instance, responding to referee reports or making suggestions for changes. But at present there is no way to "accept" these changes and make them part of the LaTeX file.

Right now, one has to go through with a text editor and implement them all by hand. It would be very useful if there were a way to "implement" these changes in the LaTeX file itself, so that a "clean", final version of the LaTeX without these markups could be generated (for uploading to the arXiv, for instance, or for submission for a second round of referee's changes).

Ideally, this would be done by the LaTeX compiler itself as an optional output, since the aastex6 documentclass already understands these commands, after all. Alternatively, it shouldn't be too hard to sed/awk/grep it, but issues like line breaks, comments, and other precedence issues may make this solution difficult to implement in practice.

A deluxetable preceded with \startlongtable does not correctly generate all the pages of its table if the table is placed after the \bibliography{references} command, e.g when a table is in an Appendix. It only generates the first page, which has the correct "Table n continued" footer printed; but the rest of the table pages are not in the pdf.